It's better when it's simple

User Tools

Site Tools


SMTP Plugin

Compatible with DokuWiki

2016-06-26, Hrun, Detritus, 2017-02-19+

plugin Configure a SMTP server (with optional auth) for sending mails from within DokuWiki

Last updated on
Admin, Action
Conflicts with

Similar to swiftmail

Tagged with email, smtp, smtpauth

This plugin replaces the way DokuWiki sends emails. Instead of relying on PHP's built-in mail function, it will contact a configured SMTP server directly to send emails. This is especially useful when configuring PHP for sending mails is complicated (Windows) or not possible.

This plugin mainly replaces the old SwiftMail plugin. It supports sending HTML emails. However it does NOT support POP-before-SMTP authentication. If you still need that, you have to rely on the SwiftMail plugin. For everyone else this plugin is recommended now.


Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.



All config options can be set in the configuration manager under the “SMTP Plugin Settings” section.

Additionally you need to set up the mailfrom option, which is in the “Notification Settings” section of the configuration manager.

When the debugging option is enabled the whole SMTP session will be printed directly to the screen when sending the mail fails. You should disable this when your setup works.


The plugin adds a new item to the Admin screen. Using this you can trigger sending a test mail from DokuWiki. If something goes wrong sending this mail, a detailed log is printed.

Known Issues

Empty mail body

Depending on your mail server, it may happen that the e-mails sent have an empty body. (See issue #17).

plugin/smtp.txt · Last modified: 2023-04-12 23:50 by andi

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki