Demo

Notifications

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.

E-mail

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