Notifications¶

The Notification Center (menu item Notifications) is the central place for all system notifications: which events to report, to whom and over which channel, along with email templates, SMTP settings and a delivery log.

In-app inbox (bell)¶

Every triggered notification also lands in the in-app inbox — reachable via the bell in the top right and the full page at /inbox (all roles). There you can mark messages as read, delete them or jump straight to the affected spot in the panel via a deep link. The severity (info / warning / critical) determines the color.

Events¶

In the Events tab you set two things independently per event:

Recipients (WHO): Admin, Reseller, Customer — each toggleable separately.
Channels (HOW): In-app, Email, Webhook — each toggleable separately.

The two axes are independent: the recipient toggles decide who gets notified; the channel toggles decide over what. Example: resource_throttled in-app only (no email) for the customer.

Disable email for a single event

Want no more emails for a certain event (in-app only)? Simply disable the Email channel for that event in the Events tab.

Important event types¶

Event	Trigger
`service_failed`	A systemd unit (service, mount, timer) is in the failed state — detected by the failed-unit worker
`service_down`	A server agent is unreachable
`resource_throttled`	A customer is being persistently throttled at their CPU/RAM/IO limit (not on brief spikes)
`cve_found`	New open CVEs in installed OS packages (Security Advisor)
`mail_account_compromised`	A mailbox is sending suspiciously — automatically locked
`backup_failed`	A backup run has failed
`ssl_expiring` / `disk_quota_warning` / `uptime_down`	SSL is expiring / storage quota nearly full / uptime monitor reports an outage

Email templates¶

In the Templates tab you customize the subject and HTML body of each notification email — per event and language. Placeholders in the format {{name}} are replaced on send (e.g. {{panel_name}}, {{service_name}}). Use Reset to restore the default template. If a template is missing in the target language, it falls back to German.

SMTP settings¶

In the SMTP tab you define how notification emails are sent:

Local (empty host): delivery via the local Postfix — the default.
External: an external SMTP server (host, port, user, password, sender).

A Test button sends a sample email to the admin address.

Empty SMTP host

If no SMTP server is configured, delivery is skipped — the delivery log then shows an entry "SMTP not configured" so the reason is visible.

Service-failure notification¶

The SMTP tab also contains the Service failure toggle: when active, every server installs a systemd OnFailure hook that sends an HTML email to the specified address on a failed service. It complements the service_failed notification in the Center (which can also report the same failures in-app/webhook).

Delivery log¶

The Delivery log tab lists every sent (or skipped) notification email with timestamp, recipient, event, subject, status (sent/failed) and, where applicable, the error reason. Filters by status and event help with troubleshooting.

Global kill switch

Using the panel setting notifications_enabled=false, all notifications can be switched off centrally.