User Guide

Notifications & Alerts

Stay informed about backup failures, client outages, and storage warnings. Get alerts via Discord, Slack, Telegram, email, and 100+ other services.

Notification Events

BBS monitors your backup infrastructure and generates notifications for 12 event types across 6 categories:

Backups

  • Backup Completed — A backup job finished successfully
  • Backup Failed — A backup job failed (critical)

Restores

  • Restore Completed — A restore job finished successfully
  • Restore Failed — A restore job failed

Clients

  • Client Offline — Agent hasn't sent a heartbeat (auto-resolves when reconnected)
  • Client Online — Agent reconnected after being offline

Repositories

  • Check Failed — Repository integrity check found errors
  • Compact Done — Repository compact completed

Storage

  • Storage Low — Disk usage exceeds threshold (auto-resolves when freed)
  • S3 Sync Failed — Offsite S3 sync failed
  • S3 Sync Done — Offsite S3 sync completed

Schedules

  • Missed Schedule — A scheduled backup didn't run in the expected window

Push Notifications

BBS uses Apprise to deliver push notifications to 100+ services. Configure push notifications from Settings → Push Notifications.

Push notification service configuration in Borg Backup Server showing Discord, Pushover, and Slack options
Screenshot coming soon

Supported Services

BBS includes guided setup forms for the most popular services:

  • Pushover — Mobile push notifications
  • Discord — Channel webhooks
  • Slack — Workspace integrations
  • Telegram — Bot messages
  • Email — Direct SMTP delivery via Apprise
  • ntfy — Self-hosted or ntfy.sh
  • Custom — Any Apprise-compatible URL (100+ services)

Setting Up a Service

  1. Click Add Service
  2. Select a service type from the dropdown
  3. Fill in the guided form fields
  4. Select which events should trigger notifications for this service
  5. Click Save
Tip: Create multiple services with different event selections. For example, send all failures to Discord for your team, and everything to Pushover for personal mobile alerts.

Email Notifications

BBS can send email alerts to admin users when specific events occur. Configure SMTP settings at Settings → Email Settings, then enable the event toggles for each notification type.

Recommended email alerts: Backup Failed, Client Offline, Storage Low, S3 Sync Failed, and Check Failed.

Web Interface Bell

The notification bell icon in the top navigation shows a badge count of unread notifications. Click it to see recent alerts, or click View All to access the full notifications page where you can manage and resolve alerts.

Smart Deduplication

Failure and warning notifications are deduplicated — if the same event fires repeatedly, the existing notification's count increments instead of creating duplicates. Success events always create fresh notifications.

Auto-Resolve

Some notifications resolve automatically: Client Offline resolves when the agent reconnects, Storage Low resolves when usage drops, Missed Schedule resolves when the next backup runs, and Backup Failed resolves when the next backup succeeds.