How do I send Matomo emails using SMTP server? (for example using Gmail SMTP)

Microsoft is deprecating basic authentication (username and password) for SMTP connections to smtp.office365.com. Matomo users who rely on Microsoft 365 for sending emails (e.g., system notifications, user invitations, password resets) can no longer send emails. The solution below is no longer supported.

Step 1 (required)

To configure a SMTP server for Matomo, login as the Superuser, go to Administration Settings Cog Icon > System > General Settings. Under ‘Email server settings’ you can configure the SMTP server form as follows:

  • Use SMTP server for e-mail. For Gmail SMTP use YES
  • SMTP server address. For Gmail SMTP use smtp.gmail.com
  • SMTP Port. For Gmail SMTP use 465
  • Authentication method for SMTP. For Gmail SMTP use Login
  • SMTP username. For Gmail SMTP use your gmail username
  • SMTP password. For Gmail SMTP use App specific password
  • SMTP encryption. For Gmail SMTP use SSL

Step 2 (required for Gmail as SMTP)

Follow these steps to configure SMTP via a Gmail.com account:

  • Log into Gmail
  • Go to your Google Account page (click on account icon, select “Manage your Google Account”)
  • Click on Security tab
  • Enable two-step verification (if not already enabled)
  • Go to App Passwords page
  • Select Mail and device (e.g. Matomo Server Emails) and generate.
  • Enter this generated “App password” in Matomo settings (Administration) Settings Cog Icon > Settings > Email server settings.

All Matomo emails (Scheduled PDF Reports, Password reset confirmation, etc.) will now be sent using Gmail servers.

If the emails are not sending correctly, we have a short troubleshooting guide.

Previous FAQ: How do I configure Matomo on a server without Internet?