Configuring Email

Versions 1.83 (Hayes++) to 8.08 (Kilen Woods)

MindTouch uses PHPMailer to send e-mail. It can be configured by adding these values in your LocalSettings.php:

// anonymous SMTP server
$wgSMTPServers = 'mail.server.com';

// authenticate SMTP server (only define if you need this)
$wgSMTPServers = 'mail.server.com';
$wgSMTPUser = 'login';
$wgSMTPPwd = 'password';

// $wgSMTPServers var may contain several server names or ips like this
// $wgSMTPServers = "smtp1.example.com;smtp2.example.com";

Note: these settings are for the front-end, not the API, and thus cannot be set through the Control Panel.

PHPMailer is instantiated in includes/UserMailer.php if you'd like to add in more PHPMailer-specific configuration values.

Version 9.02 (Lyons)

Users of MindTouch 9.02 or greater can also specify a port and SSL encryption:

$wgSMTPServers = 'smtp.server.com';
$wgSMTPUser = 'your_username@mindtouch.com';
$wgSMTPPwd = 'your_password';
$wgSMTPPort = 465;
$wgSMTPSecure = 'ssl';

You can also set the following config variables in the control panel:

mail/smtp-servers
mail/smtp-port
mail/smtp-secure
mail/smtp-username
mail/smtp-password

which, if they are set, will do the same thing for the PHP mailer as the page notifications.

For Gmail, use port 465 and SSL.

Users of non-authenticated SMTP servers should be aware of a bug which may cause e-mail not to be delivered.

Using the Exim mail server

On the VM, you have the Exim mailer available to you.  You can have it listen for mail from MindTouch and deliver it to an upstream server for you.  Configure it with the command dpkg-reconfigure exim4-config - here are the answers you probably want:

• Choose mail sent by SMARTHOST; received via SMTP or fetchmail
• Type System Mail Name: e.g. company.com
• Type IP Adresses to listen on for incoming SMTP connections: 127.0.0.1
• Leave Other destinations for which mail is accepted: blank
• Leave Machines to relay mail for: blank
• Type Machine handling outgoing mail for this host (smarthost): smtp.server.com::port
• Choose NO, don't hide local mail name in outgoing mail.
• Chose NO, don't keep number of DNS-queries minimal (Dial-on-Demand).
• Choose YES, split configuration into small files

It is also possible to configure Exim to relay to Gmail.