All integrations DevOps

Grafana + MailKite

Grafana is the leading open-source observability platform. Point its SMTP at MailKite and every alert, report, and notification goes out over your own DKIM-signed domain.

What you need

A verified domain with SPF + DKIM published
Your API key (mk_live_…)
Grafana instance (self-hosted or cloud)

Configure SMTP

Edit your grafana.ini configuration file and add the [smtp] section with MailKite credentials. You can also use environment variables (GF_SMTP_*) for containerized deployments.

SMTP Host	`smtp.mailkite.dev`
SMTP Port	`587`
Encryption	TLS (STARTTLS)
Username	`mailkite`
Password	Your API key (`mk_live_…`)
From Address	`alerts@yourdomain.com` (on a verified domain)

grafana.ini

# grafana.ini

[smtp]
enabled = true
host = smtp.mailkite.dev:587
user = mailkite
password = mk_live_...
from_address = alerts@yourdomain.com
from_name = Grafana
starttls_policy = MandatoryStartTLS

Test it

Create an alert rule and trigger it, or go to Alerting → Contact points → Test to send a test notification through the configured SMTP transport.

Troubleshooting

Emails not sending — confirm the from_address is on a verified domain.
535 Authentication failed — your password must be your mk_live_… API key, not a separate SMTP password.
Grafana Cloud users — configure SMTP in the Grafana Cloud console, not in grafana.ini.
Restart required — restart Grafana after editing grafana.ini for changes to take effect.

See the SMTP relay docs for the full connection reference, or all integrations for other platforms.