Skip to content

Configuring SMTP Email for Your Instances#

This guide explains how to enable email sending (user invites, password resets, scheduled reports, and alerts) on your Matomo and Sentry instances.

Email is configured once per application using the credentials below. The settings take effect immediately and persist across future updates.

Your SMTP credentials#

Setting Matomo Sentry
Instance matomo.unityhealth.ametnes.net sentry.unityhealth.ametnes.net
SMTP server smtp.sendgrid.net smtp.sendgrid.net
SMTP port 587 587
Encryption STARTTLS (TLS) STARTTLS (TLS)
Username apikey apikey
Password (API key) [MATOMO API KEY] [SENTRY API KEY]
From email address matomo+unityhealth@ametnes.net sentry+unityhealth@ametnes.net
From name Matomo - Unity Health Sentry - Unity Health

The password values in brackets are the API keys provided to you separately. Treat them like passwords - they are scoped to sending email only.

1. Configure Matomo#

  1. Log in to your Matomo instance (matomo.unityhealth.ametnes.net) as an administrator.
  2. Go to Administration → System → Mail server settings.
  3. Enter the following:
Field Value
SMTP server smtp.sendgrid.net
SMTP port 587
SMTP protocol TLS
SMTP authentication Login
Username apikey
Password [MATOMO API KEY]
From email address matomo+unityhealth@ametnes.net
From name Matomo - Unity Health
  1. Click Save.
  2. In Settings → Users (User Manager), add both of the following email domains to the list of allowed domains so that invitations and account emails can be sent to and from them:
  3. ametnes.net
  4. unityhealth.to
  5. Click Send test email to verify. Check the recipient's inbox (and spam folder) - delivery usually takes under a minute.

2. Configure Sentry#

  1. Log in to your Sentry instance (sentry.unityhealth.ametnes.net) as an administrator (superuser).
  2. Go to Settings → Admin → Mail.
  3. Enter the following:
Field Value
Mail Server Host smtp.sendgrid.net
Mail Server Port 587
Use TLS Enabled
Mail Server Username apikey
Mail Server Password [SENTRY API KEY]
From Email Address sentry+unityhealth@ametnes.net
From Name Sentry - Unity Health (optional)
  1. Click Save. The settings take effect immediately - no restart needed.
  2. Verify by sending a user invite (Organization Settings → Members → Invite Member) or by resetting a user's password.

Troubleshooting#

  • Test email fails to send - confirm the password (API key) is entered exactly as provided, the username is apikey, the port is 587, and TLS is enabled.
  • Email accepted but not received - check the recipient's spam folder; delivery can take a minute or two.
  • Email delivered to wrong address - the recipient address is set by the application (the user's own email), not by the SMTP settings above.

What these credentials do not do#

  • These are sending-only credentials. Neither Matomo nor Sentry receives or reads incoming email - no mailbox is associated with the From addresses.
  • Bounced or failed deliveries are handled by the sending service and do not require any action from you.