Help:Email

From canasta

Email

Canasta requires $wgSMTP to be configured in order to send email. This covers account confirmations, password resets, watchlist notifications, and user-to-user email.


Configuring email

Configure $wgSMTP in your wiki's settings file to route email through an authenticated SMTP provider.

Example using a generic SMTP provider:

$wgSMTP = [
    'host'     => 'ssl://smtp.example.com',
    'IDHost'   => 'example.com',
    'port'     => 465,
    'auth'     => true,
    'username' => 'your-username',
    'password' => 'your-password',
];

Popular providers include Amazon SES, SendGrid, Mailgun, and Brevo. Most offer a free tier sufficient for small wikis.


Disabling email entirely

To prevent the wiki from sending any email at all, set $wgEnableEmail to false in your wiki's settings file:

$wgEnableEmail = false;

Troubleshooting

Emails not sent after configuring $wgSMTP

  • Verify the SMTP credentials are correct by testing with a simple PHP script
  • Check that your hosting provider does not block outbound connections on the SMTP port (465 or 587)
  • Look for errors in the MediaWiki debug log (set $wgDebugLogFile temporarily)