Notifications go out when a check changes state: from healthy to failing and back. While a check keeps failing, Lantern repeats the message every repeat interval, by default every hour.
notify:
- type: email
to: ops@example.org
smtp:
host: mail.example.org
port: 587
user: lantern
# password from LANTERN_SMTP_PASSWORD
Webhook
Lantern sends a POST request with a JSON body to the URL. Answer with a status code from 200 to 299; anything else is retried three times.
{
"check": "Website",
"state": "failing",
"since": "2026-10-19T08:14:03Z",
"reason": "status 503, expected 200"
}
Quiet hours
Messages in quiet hours wait until the end of the window and arrive as one summary. Recoveries during the window are included.
notify:
- type: email
to: ops@example.org
quiet: "22:00-07:00"
repeat: 2h