Emails from Matomo are not being sent, how do I troubleshoot and solve the issue?

On-Premise

If emails from Matomo are not being sent, for example through scheduled email reports or password reset emails, or you receive the error [Zend_Mail_Protocol_Exception] 5.1.7 Bad sender address syntax while executing the core:archive console command via crontab, then please follow the steps below to identify and resolve the issue.

Edit your config/config.ini.php and under the [General] category add the following:

noreply_email_address = "noreply@your-domain-here.com"

This should fix the issue and your Matomo emails should now be sent.

If your emails are still not sent from Matomo, then run the following command (requires at least Matomo 3.10.0) to send a test email (replace your-real-email-address@example.com by your real email address):

Linux/macOS:

./console core:test-email your-real-email-address@example.com

Windows (PHP available in PATH):

php console core:test-email your-real-email-address@example.com

Windows (full PHP path):

"C:\Program Files\PHP\php.exe" "C:\matomo\console" core:test-email your-real-email-address@example.com
  • If PHP is added to the system PATH, you can use the shorter php console syntax.
  • Run the command from the Matomo root directory unless using full paths.

Troubleshooting

If you are not able to receive emails from Matomo with the default configuration, we recommend to try to configure a SMTP server to send all emails from Matomo as this will likely solve the issue.

If you are receiving an SMTP Error: Could not authenticate then read here how to resolve this issue.

If your SSL certificate is self-signed, you may need to edit your Matomo configuration file.

Previous FAQ: Flatlined Data, Hollow Dots, and Report Invalidations