Skip to main content

Desktop-Benachrichtigungen (Web Push)

Menü: Glocke → Desktop-Benachrichtigungen einrichten — oder Avatar → Meine Benachrichtigungen
Pfad: /dashboard/account/notifications (alle Rollen)

Organisatorische Kanäle (Slack, Webhooks, …): Einstellungen → Benachrichtigungen (/dashboard/settings/notifications, nur Admin-Rollen).

Echte Browser-Push-Meldungen am Desktop — auch wenn cockpitOS minimiert ist oder der Tab im Hintergrund läuft.

Was​

  • Web Push über Service Worker (/push-sw.js)
  • Auslösung zentral bei jeder DashboardNotification (Glocke): Freigaben, Kommentare, Token-Hinweise
  • Glocke & Push: GET /api/notifications filtert serverseitig — nur Einträge, für die du heute noch Center-Zugang und die passende Rolle/Pool-Zuständigkeit hast (Schutz vor veralteten oder falsch zugestellten Meldungen).
  • Opt-in pro Nutzer und Gerät

Warum​

Prüfer sollen Freigabe-Anfragen sofort sehen — ohne ständig die Glocke oder E-Mail zu prüfen.

Wer ist betroffen​

RolleAktion
Prüfer / RedaktionPush in Präferenzen aktivieren, Browser-Erlaubnis erteilen
IT / BetriebVAPID-Keys auf Render setzen, Migration ausführen

So aktivieren (Nutzer)​

  1. Glocke oben rechts → Desktop-Benachrichtigungen einrichten — oder Avatar → Meine Benachrichtigungen
  2. Desktop-Benachrichtigungen einschalten
  3. Im Browser Benachrichtigungen erlauben (Chrome/Edge empfohlen)
  4. Test: Social-Post zur Freigabe senden — Prüfer erhält Desktop-Meldung + Eintrag in der Glocke

Betrieb (IT)​

Env (Render / Coolify)​

npx web-push generate-vapid-keys
VariableZweck
VAPID_PUBLIC_KEYÖffentlicher Schlüssel (auch an Browser)
VAPID_PRIVATE_KEYGeheim, nur Server
VAPID_SUBJECTz. B. mailto:notifications@cockpit-os.de (optional, sonst EMAIL_FROM)

Migration (einmalig)​

psql "$DATABASE_URL" -f packages/database/migrations/20260708200000_add_desktop_push_SAFE.sql

APIs​

MethodePfadZweck
GET/api/users/me/push-configVAPID Public Key, Status
POST/api/users/me/push-subscriptionGerät registrieren
DELETE/api/users/me/push-subscriptionGerät / alle Geräte entfernen
PATCH/api/users/me/notification-preferencesdesktopPushEnabled

Push-Versand: automatisch in createDashboardNotification() — kein separater Cron.

Grenzen​

  • Browser muss Push unterstützen (Desktop Chrome/Edge/Firefox; iOS nur eingeschränkt)
  • Nutzer muss Opt-in + OS-Benachrichtigungen erlauben
  • E-Mail bleibt Fallback bei abgelaufenen Subscriptions oder fehlender Berechtigung

Siehe auch​

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/dashboard/desktop-push-benachrichtigungen