How do I get alerts when a backup fails?
Turn on email alerts under Settings → Alerts (off by default) and add Slack, Discord or webhook channels under Settings → Notifications. Each job needs Email a status report for this job switched on to send email.
Email alerts
- Open Settings → Alerts.
- Under "Email alerts", switch on Enable email alerts. It is off by default.
- Fill in the SMTP server: Host, Port, Username, Password and From address. Choose STARTTLS (port 587) or Implicit SSL (port 465) and keep "Verify TLS certificate" on if you can. Leave Username blank for an unauthenticated relay.
- Under "Recipients & defaults", enter the Default recipients (comma-separated) and choose the Default events: Failure, Partial (some accounts failed) and Success. Failure and Partial are the default.
- Under "Send a test", enter a recipient and choose Send test. Save your changes first.
- In each job that should send mail, switch on Email a status report for this job and choose "Notify on". Leave recipients blank to use the default.
The SMTP password is stored encrypted. A job can override the recipients and events.
Slack, Discord and webhooks
- Open Settings → Notifications ("Notification Channels") and add a channel.
- Pick the type (Slack, Discord or Webhook), give it a name, paste the incoming-webhook URL (it must start with
http://orhttps://) and choose the events. - Choose Test on the channel.
Events you can choose: All events, Backup failed, Backup completed, Integrity damaged, Restore failed or with errors, Migration failed or with errors, and Disaster Recovery not set up (weekly). A webhook receives a small JSON message with event, level, title, message, server and timestamp.
What reaches which channel
- Backups that finish with warnings arrive as a "partial" alert. Email shows "completed with errors". On channels it comes through Backup failed, titled "Backup job 'X' partial".
- A failed weekly restore check raises
restore_check_failed. - Disaster Recovery failures reach Slack, Discord and webhook channels only if the channel has All events selected; you cannot pick DR events by name.
- Until Disaster Recovery is set up, a weekly notification goes out when any job has Encrypt backup data on, by email and to every channel with All events or Disaster Recovery not set up (weekly).
What alerts do not cover
Alerts are opt-in and narrow. There is nothing for a missed schedule, a stopped worker, low disk space or an expiring certificate, and no Telegram, Teams or other channel yet. Delivery is tried once and never retried. Watch the Dashboard and the Backup points page as well.