SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

ntfy selbst hosten: Push-Alarme per Docker Compose

Betreiben Sie ntfy auf einem eigenen VPS mit TLS, Benutzern und ACLs. Sichern Sie Topics und senden Sie Alarme aus cron sowie systemd-OnFailure-Units.

Was ein selbst gehosteter ntfy-Server leistet

Ein selbst gehosteter ntfy-Server wandelt eine HTTP-POST-Anfrage in eine Push-Benachrichtigung auf Ihrem Telefon um. Sie veröffentlichen Nachrichten mit curl. Die Nachricht erreicht die Android-App, die iOS-App, einen Browser-Tab oder jedes andere Ziel, das eine HTTP-Verbindung offen halten kann. Sie müssen keine Client-Bibliothek installieren und keinen Message Broker betreiben.

ntfy adressiert Nachrichten über ein Topic. Ein Topic ist ein Name im URL-Pfad, etwa https://ntfy.example.com/alerts. Es wird in dem Moment angelegt, in dem jemand eine Nachricht dorthin veröffentlicht. Bei einer Standardinstallation kann jeder, der diesen Namen kennt, das Topic lesen und Nachrichten dorthin schreiben. Deshalb vergleicht die Dokumentation des Projekts den Topic-Namen mit einem Passwort. Dieses Modell ist für den öffentlichen Dienst ntfy.sh geeignet. Für einen Server, der die Fehler Ihrer Backups meldet, ist es nicht geeignet. Daher aktiviert diese Anleitung die Authentifizierung, bevor die erste Nachricht gesendet wird.

Voraussetzungen

Sie benötigen einen VPS mit Ubuntu 24.04 oder Debian 13, Docker Engine und dem Compose-Plugin, einen Domainnamen und sehr wenig RAM. Erstellen Sie einen DNS-A-Record (domain name system), der ntfy.example.com auf die öffentliche IP-Adresse des Servers verweist. Prüfen Sie anschließend, ob der Name aufgelöst wird, bevor Sie weitere Schritte ausführen.

dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw status

dig muss die IP-Adresse Ihres Servers ausgeben. Für die Ausstellung des Zertifikats muss der Hostname über einen A- oder AAAA-Record öffentlich auf den Server aufgelöst werden. Port 80 bleibt geöffnet, weil ACME (automatic certificate management environment), das Protokoll hinter Let's Encrypt, ihn für die HTTP-Challenge verwendet. Der ntfy-Container erhält selbst keinen öffentlich erreichbaren Port.

ntfy-Konfigurationsdatei erstellen

Das Docker-Image enthält keine Konfigurationsdatei. Sie erstellen daher eine. Jeder spätere Befehl in dieser Anleitung liest daraus. Ermitteln Sie zuerst die Benutzer-ID und die Gruppen-ID, unter denen der Container ausgeführt wird.

id -u
id -g
sudo install -d -o "$(id -u)" -g "$(id -g)" /etc/ntfy /var/cache/ntfy /var/lib/ntfy
sudo nano /etc/ntfy/server.yml
base-url: "https://ntfy.example.com"
listen-http: ":2586"
behind-proxy: true
cache-file: "/var/cache/ntfy/cache.db"
cache-duration: "12h"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
enable-login: true
enable-signup: false

Vier dieser Zeilen sind entscheidend. base-url muss exakt der öffentliche HTTPS-Adresse entsprechen, weil ntfy sie für generierte Links zu Anhängen und selbst gehostete iOS-Push-Benachrichtigungen verwendet. listen-http: ":2586" bindet innerhalb des Containers an alle Schnittstellen. Das wirkt zunächst unvorsichtig, ist aber korrekt: Der Container verwendet einen eigenen Netzwerk-Namensraum. Wenn dort an 127.0.0.1 gebunden würde, wäre der Port vom Host aus nicht erreichbar, und der von Docker veröffentlichte Port könnte keine Verbindung herstellen. auth-default-access: "deny-all" definiert die gesamte Sicherheitsrichtlinie, weil Lese- und Schreibzugriffe ohne ausdrückliche Berechtigung verweigert werden. behind-proxy: true weist ntfy an, die Client-Adresse aus dem Header X-Forwarded-For zu übernehmen. Dadurch berücksichtigen die Ratenbegrenzungen die tatsächlichen Besucher, statt den Reverse Proxy als einen einzigen, sehr aktiven Client zu zählen.

enable-login: true ermöglicht Benutzern die Anmeldung über die Webanwendung oder die API. enable-signup bleibt auf false gesetzt, weil die selbstständige Kontoerstellung auf einem privaten Server mit zusätzlichen Schritten einen offenen Zugang schaffen würde.

sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.yml

ntfy mit Docker Compose ausführen

Fügen Sie dies in /opt/ntfy/compose.yaml ein und ersetzen Sie 1000:1000 durch die beiden oben ausgegebenen Zahlen id -u und id -g.

services:
  ntfy:
    image: binwiederhier/ntfy:v2.36.0
    container_name: ntfy
    command: serve
    user: "1000:1000"
    environment:
      - TZ=UTC
    volumes:
      - /etc/ntfy:/etc/ntfy
      - /var/cache/ntfy:/var/cache/ntfy
      - /var/lib/ntfy:/var/lib/ntfy
    ports:
      - "127.0.0.1:2586:2586"
    restart: unless-stopped
cd /opt/ntfy
sudo docker compose up -d
sudo docker compose logs ntfy
curl -s http://127.0.0.1:2586/v1/health

Ein gesunder Server antwortet auf {"healthy":true,"role":"active"}. Zwei Details in dieser Compose-Datei sind absichtlich so gewählt. Das Image ist auf v2.36.0 festgelegt, das am 1. November 2026 aktuelle stabile Release, statt auf latest. Mit latest lädt der nächste docker compose pull das aktuelle Image herunter, und ein anschließendes docker compose up -d erstellt den Container damit neu. Das alleinige Abrufen ändert die Version des laufenden Servers nicht. Auch ein festgelegtes Image muss aktualisiert werden. Allein im Oktober 2026 gab es zehn Releases: v2.29.0 am 7. Oktober, v2.30.0 am 12. Oktober, v2.31.0 und v2.31.1 am 16. Oktober, v2.32.0 am 18. Oktober, v2.33.0 und v2.33.1 am 23. Oktober, v2.34.0 am 24. Oktober, v2.35.0 am 30. Oktober und v2.36.0 am 31. Oktober. v2.31.0 behebt den Verlust von Nachrichten, wenn ein Client die Verbindung wiederherstellte, bevor sie den Nachrichtencache erreichten. Bei erneuten Verbindungen mit since=<message ID> werden jedoch alle Nachrichten des Themas aus der Datenbank gelesen, und ntfy.sh hat diese Version zurückgezogen. v2.31.1 behebt diese Last mit einem neuen Index. v2.34.0 behebt das Problem, dass widerrufene oder gelöschte Benutzer einige Abonnements behielten. v2.35.0 behebt gleichzeitige Anfragen, die gültige Zugangsdaten als anonym behandelten, sowie eine Autorisierungsumgehung im Matrix-Push-Gateway auf SQLite. Verschieben Sie ältere Festlegungen daher auf v2.36.0. Der Port wird als 127.0.0.1:2586:2586 veröffentlicht. Der Container ist dadurch nur über die Loopback-Adresse des Hosts erreichbar. Schreiben Sie stattdessen 2586:2586. Docker fügt dann seine eigenen Firewall-Regeln vor Ihren Regeln ein. Dadurch antwortet der Port aus dem Internet, obwohl ufw status angibt, dass er geschlossen ist. Beide Vorgehensweisen gelten auch für den nächsten Container, den Sie hinzufügen: ein selbst gehostetes RustDesk-Relay legt den Image-Tag auf dieselbe Weise fest. Es kann sich jedoch nicht hinter der Loopback-Adresse verbergen, weil seine Signal- und Relay-Ports aus dem Internet erreichbar sein müssen.

Wenn curl Connection refused ausgibt, lesen Sie das Container-Log. Ein Berechtigungsfehler bei /var/lib/ntfy/user.db bedeutet, dass die Zeile user: nicht dem Eigentümer dieser Verzeichnisse entspricht. Der Prozess kann dadurch seine eigene Datenbank nicht erstellen und beendet sich. Der Leitfaden zu den Docker-Compose-Grundlagen für einen VPS behandelt Eigentümer von Volumes und Neustartrichtlinien ausführlicher.

TLS mit Caddy vorschalten

Caddy fordert das Zertifikat selbstständig an und erneuert es. Damit ist TLS (Transport Layer Security) mit dem geringsten Aufwand einsatzbereit.

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy

Ersetzen Sie den Inhalt von /etc/caddy/Caddyfile durch drei Zeilen.

ntfy.example.com {
    reverse_proxy 127.0.0.1:2586
}
sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/health

Dasselbe {"healthy":true,"role":"active"} über HTTPS bedeutet, dass der gesamte Pfad funktioniert. Ein 502 von Caddy bedeutet normalerweise, dass ntfy nicht auf Verbindungen wartet: Prüfen Sie dies mit sudo ss -lntp | grep 2586. Wenn ntfy auf Verbindungen wartet und 502 weiterhin auftritt, protokolliert Caddy den Upstream-Fehler, auf den es gestoßen ist, beispielsweise eine zurückgesetzte Verbindung. Ein Zertifikatsfehler bedeutet normalerweise, dass der DNS-Eintrag falsch ist oder die Zertifikatsvalidierung den Server auf Port 80 oder 443 nicht erreichen kann. Prüfen Sie sudo journalctl -u caddy -n 50 auf den Validierungsfehler. Wenn Sie später einen weiteren Dienst hinzufügen, benötigen Sie im selben Caddyfile einen weiteren Hostnamen-Block. So kann beispielsweise Halcyon, eine Videoshop-Oberfläche aus den 90ern für Ihre Jellyfin-Bibliothek auf einer zweiten Subdomain desselben Servers erreichbar werden.

Wenn Sie bereits nginx einsetzen, übernehmen Sie die von ntfy dokumentierten Proxy-Einstellungen: proxy_http_version 1.1, proxy_buffering off, proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for sowie Lese- und Schreib-Timeouts von mindestens drei Minuten. Ein Subscriber hält eine HTTP-Verbindung so lange offen, wie er auf Nachrichten wartet. Das standardmäßige proxy_read_timeout von nginx mit 60 Sekunden zählt nur die Zeit zwischen zwei Lesevorgängen. ntfy sendet standardmäßig alle 45 Sekunden eine Keepalive-Nachricht (keepalive-interval), damit Vermittler die Verbindung wegen Inaktivität nicht schließen. Ein stiller Subscriber bleibt daher auch hinter dem Standard-nginx verbunden. Die längeren Timeouts schaffen zusätzliche Reserve, halten die Verbindung aber nicht aktiv. Wenn Sie keepalive-interval erhöhen, muss der Wert unter dem Read-Timeout Ihres Proxys bleiben.

Benutzer anlegen und Topics absichern

Die Authentifizierung ist aktiviert, und bisher hat niemand Zugriff auf irgendetwas. Genau das ist beabsichtigt. Legen Sie ein Administratorkonto für sich selbst und ein Maschinenkonto für Skripte an. Diese Befehle lesen /etc/ntfy/server.yml aus dem Container. Deshalb ist die Konfigurationsdatei als Volume eingebunden.

sudo docker compose exec ntfy ntfy user add --role=admin admin
sudo docker compose exec ntfy ntfy user add robot
sudo docker compose exec ntfy ntfy user list

Jeder user add-Befehl fordert ein Passwort an. Ein Administrator umgeht die Zugriffsliste und kann jedes Topic lesen und beschreiben. Verwenden Sie dieses Konto daher nur für sich selbst und die Smartphone-App. robot ist ein normaler Benutzer ohne jeglichen Zugriff, bis Sie ihm Berechtigungen erteilen.

sudo docker compose exec ntfy ntfy access robot alerts write
sudo docker compose exec ntfy ntfy access robot "alerts_*" write
sudo docker compose exec ntfy ntfy access

Ein ACL-Eintrag (Access Control List) besteht aus einem Benutzer, einem Topic und einer Berechtigung. Das Topic ist entweder ein wörtlicher Name oder ein Muster, in dem * für beliebige Zeichen steht. Dadurch deckt alerts_* die Topics alerts_backup und alerts_db ab, ohne dass Sie für jeden Host einen eigenen Befehl ausführen müssen. Die Berechtigung write bedeutet, dass nur veröffentlicht werden darf. Dadurch kann ein aus einem Cronjob gestohlener Token keine Topics abonnieren und die gesendeten Daten zurücklesen. Der spezielle Benutzername everyone legt fest, was ein nicht authentifizierter Besucher tun darf. Mit deny-all als Standardwert verwenden Sie diese Regel hauptsächlich, um etwas absichtlich öffentlich zugänglich zu machen, beispielsweise ntfy access everyone status read. Außerdem akzeptiert sie deny, wenn Sie ausdrücklich festlegen möchten, dass anonyme Besucher keinen Zugriff auf ein Topic erhalten.

Skripte sollten einen Token und nicht Ihr Passwort verwenden.

sudo docker compose exec ntfy ntfy token add robot

Der Befehl gibt einen Token aus, der mit tk_ beginnt. Ein Token übernimmt exakt die Berechtigungen des Benutzers, zu dem er gehört. Dieser Token kann daher auf den Topics alerts veröffentlichen und sonst nichts tun. ntfy token list zeigt vorhandene Token an, und ntfy token remove widerruft einen Token, ohne das Passwort des Benutzers zu ändern.

Ihre erste Nachricht senden und prüfen, ob die Sperre funktioniert

Prüfen Sie zuerst, ob die Tür geschlossen ist.

curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alerts

Das gibt 403 aus. 403 ist die erwartete Antwort: auth-default-access: "deny-all" verweigert eine anonyme Veröffentlichung. Senden Sie jetzt eine echte Nachricht.

curl -H "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN" \
  -H "Title: Nightly backup finished" \
  -H "Priority: default" \
  -H "Tags: white_check_mark" \
  -d "42 GB copied in 11 minutes" \
  https://ntfy.example.com/alerts

Der Server antwortet mit der gespeicherten Nachricht als JSON. Daran erkennen Sie, dass sie akzeptiert und nicht verworfen wurde. Title ist die fett formatierte erste Zeile. Priority reicht von 1 bis 5 oder anhand des Namens von min bis urgent. Damit wird festgelegt, ob das Telefon einen Ton ausgibt. Tags werden in der Benachrichtigung zu Emojis, wenn der Name einem bekannten Emoji-Kürzel entspricht. Andernfalls bleiben sie Klartext.

Um ein Topic in einem Terminal zu überwachen, streamen Sie es:

curl -s -u admin https://ntfy.example.com/alerts/raw

curl fordert das Passwort an. Jede Nachricht wird als eine Zeile empfangen. Die gelegentlich auftretenden Leerzeilen dienen als Keepalives. Wenn Sie https://ntfy.example.com in einem Browser öffnen und sich mit demselben Konto anmelden, erhalten Sie die Web-App-Version desselben Streams.

Ratenlimits festlegen, damit ein Skript den Server nicht überfluten kann

Standardmäßig erhält jeder Besucher einen Bucket mit 60 Anfragen. Dieser wird mit einer Anfrage alle 5 Sekunden wieder aufgefüllt. Für einen privaten Server ist das großzügig bemessen. Ein Skript, das in einer Wiederholungsschleife festhängt, verbraucht den gesamten Vorrat. Fügen Sie server.yml Limits hinzu.

visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500
sudo docker compose restart ntfy

Ein Besucher, der das Limit überschreitet, erhält HTTP 429 statt einer zugestellten Nachricht. Das Limit wird pro Besucheradresse gezählt. Deshalb ist behind-proxy: true so wichtig: Ohne diese Einstellung sieht ntfy nur die Adresse von Caddy. Jeder Client gilt dann als derselbe Besucher, und ein lautes Skript leert den Bucket, den Ihr Telefon und Ihre anderen Server gemeinsam verwenden. Ab v2.36.0 bleiben die Tageszähler in der Benutzerdatenbank auch nach Neustarts erhalten. Das Kontingent jedes Besuchers wird in einem eigenen 24-Stunden-Zyklus zurückgesetzt und nicht um Mitternacht UTC.

Benachrichtigung bei einem fehlgeschlagenen Cron-Job

Übergeben Sie das Token nicht in der Befehlszeile. ps aux zeigt jedem Benutzer auf dem System die vollständige Befehlszeile jedes laufenden Prozesses an. Ein mit -H übergebenes Token ist daher für die gesamte Laufzeit von curl für jedes lokale Konto lesbar. Eine curl-Konfigurationsdatei verhindert das.

sudo install -d -m 700 /etc/ntfy-alert
printf 'header = "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN"\n' | sudo tee /etc/ntfy-alert/curlrc
sudo chmod 600 /etc/ntfy-alert/curlrc

Kapseln Sie den Job nun. Speichern Sie ihn als /usr/local/bin/backup-with-alert.sh und machen Sie ihn mit chmod 750 ausführbar.

#!/bin/bash
out=$(/usr/local/bin/backup.sh 2>&1)
code=$?
if [ "$code" -ne 0 ]; then
  printf '%s' "$out" | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
    -H "Title: backup.sh failed with exit $code" \
    -H "Priority: high" \
    -H "Tags: warning" \
    --data-binary @- \
    https://ntfy.example.com/alerts
fi
exit "$code"
17 3 * * * /usr/local/bin/backup-with-alert.sh >> /var/log/backup-alert.log 2>&1

$? wird in der Zeile unmittelbar nach dem Befehl erfasst, weil der nächste ausgeführte Befehl den Wert überschreiben würde. Die Ausgabe wird über tail -c 1000 geleitet, weil ntfy eine maximale Nachrichtengröße erzwingt und eine Benachrichtigung kein Log-Viewer ist. Das abschließende exit "$code" bewahrt den ursprünglichen Status. Dadurch erkennt jede andere Überwachung dieses Jobs weiterhin einen Fehler. Testen Sie den gesamten Ablauf, indem Sie das Skript für einen Lauf auf /bin/false verweisen.

Ein Fehlerzweig, der nie ausgeführt wird, ist schlechter als gar keine Benachrichtigung. Er erweckt den Eindruck, dass ausbleibende Meldungen Erfolg bedeuten. Cron stellt Ihrem Job eine nahezu leere Umgebung und eine wesentlich kürzere PATH als Ihre Login-Shell bereit. Daher kann ein Skript, das bei manueller Ausführung funktioniert, bereits beendet werden, bevor es die curl-Zeile erreicht. Der Leitfaden dazu, warum ein Cron-Job nicht ausgeführt wird behandelt diese Umgebungsprobleme. Verwenden Sie überall absolute Pfade. Lesen Sie nach dem ersten geplanten Lauf die Logdatei, anstatt vom Erfolg auszugehen.

Benachrichtigung bei einem fehlgeschlagenen systemd-Unit

Cron deckt geplante Aufgaben ab. Für langlebige Dienste benötigen Sie OnFailure=. systemd führt sie aus, sobald eine Unit den Zustand failed erreicht. Erstellen Sie eine Template-Unit und verwenden Sie sie für jeden Dienst auf dem Server wieder. Speichern Sie sie als /etc/systemd/system/ntfy-unit-failed@.service.

[Unit]
Description=Send an ntfy alert because %i failed

[Service]
Type=oneshot
ExecStart=/usr/local/bin/ntfy-unit-failed %i

Führen Sie anschließend /usr/local/bin/ntfy-unit-failed aus und setzen Sie den Modus auf 750:

#!/bin/bash
unit="$1"
journalctl -u "$unit" -n 15 --no-pager -o cat | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
  -H "Title: $unit failed on $(hostname -s)" \
  -H "Priority: urgent" \
  -H "Tags: rotating_light" \
  --data-binary @- \
  https://ntfy.example.com/alerts

Binden Sie sie mit einem Drop-in an einen Dienst an. Dadurch kann ein Paket-Upgrade Ihre Anpassung nicht überschreiben.

sudo systemctl edit myapp.service
[Unit]
OnFailure=ntfy-unit-failed@%n.service

%n wird zum vollständigen Namen der Unit erweitert. Dadurch wird die instanziierte Unit zu ntfy-unit-failed@myapp.service.service. %i in der Template-Unit übergibt myapp.service als erstes Argument an das Skript. So kann eine Template-Unit für jede Unit verwendet werden. Testen Sie die Funktion mit einer Unit, die absichtlich fehlschlägt. Speichern Sie sie als /etc/systemd/system/ntfy-selftest.service.

[Unit]
Description=Deliberately failing unit
OnFailure=ntfy-unit-failed@%n.service

[Service]
Type=oneshot
ExecStart=/bin/false
sudo systemctl daemon-reload
sudo systemctl start ntfy-selftest.service

Der Startbefehl wird mit einem Exit-Status ungleich 0 beendet und gibt Job for ntfy-selftest.service failed because the control process exited with error code aus. Das Telefon sollte etwa eine Sekunde später vibrieren. Löschen Sie die Test-Unit anschließend.

Ein Fallstrick ist wichtig. OnFailure= wird nur ausgeführt, wenn eine Unit den Zustand failed erreicht. RestartMode=direct überspringt diesen Zustand bei automatischen Neustarts und überspringt dadurch auch den Fehler-Handler. Mit dem Standardwert RestartMode=normal durchlaufen automatische Neustarts den Zustand failed. StartLimitBurst und StartLimitIntervalSec steuern, wann wiederholte Starts abgelehnt werden. Setzen Sie diese Werte so, dass eine Absturzschleife schließlich beendet wird. Timer sind der sauberere Ersatz für das obige Cron-Muster, weil die Service-Unit eines Timers dasselbe OnFailure=-Drop-in unterstützt. Der Leitfaden zu systemd-Services und Timern auf einem VPS beschreibt die Umstellung ausführlich.

Einen Uptime-Monitor in dasselbe Topic integrieren

Uptime Kuma, der selbst gehostete Statusmonitor, unterstützt den Benachrichtigungstyp ntfy. Öffnen Sie Settings, anschließend Notifications und dann Setup Notification. Wählen Sie Ntfy aus, setzen Sie die Server-URL auf https://ntfy.example.com und das Topic auf alerts, wählen Sie eine Priorität und fügen Sie das Zugriffstoken robot ein. Senden Sie die Testbenachrichtigung, bevor Sie speichern. Ein falscher Topic-Name führt zu einem Fehler bei einer write-Berechtigung, die dieses Topic nicht abdeckt.

Die Einschränkung dieser Konfiguration ist eindeutig: Ein Monitor, der auf derselben VPS läuft, kann nicht erkennen, dass die VPS ausgefallen ist. Außerdem kann ntfy nicht melden, dass ntfy selbst ausgefallen ist. Betreiben Sie den Monitor auf einem anderen Rechner und geben Sie ihm einen zweiten Benachrichtigungskanal, beispielsweise E-Mail, für den Monitor, der ntfy selbst überwacht. Der Monitortyp Push von Uptime Kuma deckt den anderen blinden Fleck ab: Ihr Cronjob ruft nach einem erfolgreichen Lauf eine Push-URL auf, und Kuma alarmiert Sie, wenn diese Aufrufe ausbleiben. Ein Fehlerzweig wird nur ausgelöst, wenn der Job ausgeführt wird. Er sagt daher nichts über einen Job aus, der nie gestartet wurde.

Funktioniert selbst gehostetes ntfy auf Android und iPhone?

Unter Android ja, ohne Einschränkung. Installieren Sie die App aus Google Play oder F-Droid, öffnen Sie Settings, setzen Sie den Standardserver auf https://ntfy.example.com, fügen Sie Ihr Konto im Bildschirm für die Benutzerverwaltung hinzu und abonnieren Sie anschließend alerts. Die sofortige Zustellung hält einen Foreground Service aktiv, damit Nachrichten auch im Doze-Modus des Telefons eintreffen. Die dauerhafte Benachrichtigung gehört zu den Anforderungen von Android für Foreground Services und ist kein Fehler. Der F-Droid-Build enthält überhaupt keinen Firebase-Code. Daher verwendet jedes Abonnement die sofortige Zustellung. ntfy kann außerdem als UnifiedPush-Distributor fungieren, also als offene Alternative zum Push-Dienst von Google. Andere Apps, die UnifiedPush unterstützen, können dadurch ebenfalls über Ihren Server zustellen.

In der offiziellen iOS-App funktioniert es mit einer Abhängigkeit, die Sie nicht entfernen können. iOS hält eine App im Hintergrund an. Die von Apple erlaubten Hintergrundmodi (Audiowiedergabe, Empfang von Standortaktualisierungen und Verarbeitung geplanter Aufgaben) erlauben es einer App nicht, auf eine Nachricht von Ihrem Server zu warten. Eine zeitnahe Aktivierung muss daher über APNs (Apple push notification service) erfolgen. Nur ein Anbieter mit für die App autorisierten Zugangsdaten darf Nachrichten an sie senden. Ihr Server kann die offizielle App daher nicht direkt erreichen. ntfy löst das mit einem Relay: Ihr Server sendet ein poll_request mit der Nachrichten-ID an ntfy.sh. ntfy.sh leitet es über Firebase und APNs weiter, um die App zu aktivieren. Anschließend ruft die App den Nachrichtentext von Ihrem Server ab.

upstream-base-url: "https://ntfy.sh"

Machen Sie sich klar, welche Folgen das hat. Der Nachrichteninhalt bleibt auf Ihrem Server. Die Tatsache, dass eine Nachricht eingetroffen ist, und ihre ID durchlaufen jedoch eine Infrastruktur, die Sie nicht betreiben. Ohne diese Einstellung treffen Benachrichtigungen auf dem iPhone von einem selbst gehosteten Server weiterhin irgendwann ein. Die ntfy-Dokumentation warnt jedoch, dass die Verzögerung mehrere Stunden betragen kann, weil die App nicht zeitnah aktiviert wird. Um eine native iOS-App ohne das ntfy.sh-Relay zu verwenden, müssen Sie die App mit Ihrem eigenen Apple-Developer-Konto und Ihren eigenen APNs-Schlüsseln selbst bauen und veröffentlichen. Dafür fallen eine jährliche Gebühr und ein erneuter Build für jedes Update an. Eine weitere Möglichkeit ist ntfy's PWA unter iOS 16.4 oder neuer. Fügen Sie sie zum Home-Bildschirm hinzu und konfigurieren Sie Web Push auf Ihrem Server. Dadurch vermeiden Sie das ntfy.sh-Relay, verwenden aber weiterhin die Push-Infrastruktur des Browsers. Wenn das Relay für Ihren Anwendungsfall nicht akzeptabel ist, verwenden Sie die Alarmierung unter Android oder in der Desktop-Web-App.

Backups, Upgrades und das Festlegen des Image-Tags

Zwei Pfade können nicht neu erzeugt werden: /etc/ntfy/server.yml und /var/lib/ntfy/user.db. Der zweite enthält alle Benutzer, Passwort-Hashes, ACL-Einträge und Tokens. Behandeln Sie ihn daher wie einen privaten Schlüssel.

sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgz

Kopieren Sie diese Datei vom Server herunter. cache.db enthält die aktuellen Nachrichten, bei der obigen Einstellung cache-duration für 12 Stunden, sowie alle Nachrichten, deren Zustellung für einen späteren Zeitpunkt geplant ist. Solche Nachrichten bleiben bis 12 Stunden nach ihrer Zustellung erhalten. Wenn Sie keine Nachrichten im Voraus planen, verursacht der Verlust dieser Datei keinen schützenswerten Schaden. Für ein Upgrade bearbeiten Sie das Tag in der Compose-Datei, rufen das Image ab und erstellen den Container neu.

sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/health

Lesen Sie zuerst die Release-Hinweise. Die SQLite-Datenbanken werden beim Start migriert. Nach einer Änderung des Schemas ist ein Zurücksetzen auf ein älteres Tag daher nicht sicher. v2.31.1 hat den Nachrichtencache beispielsweise auf Schema-Version 17 umgestellt. In den Upgrade-Hinweisen steht, dass für ein Downgrade auf v2.31.0 oder älter diese Version manuell wieder auf 16 gesetzt werden muss. Ein Upgrade auf v2.36.0 setzt die vorhandenen Tageszähler aller Benutzer einmalig zurück. Bewahren Sie das gerade erstellte Backup auf, bis die neue Version einen Tag lang ausgeführt wurde. Die Hinweise weisen auch auf Verhaltensänderungen hin. Ab v2.31.0 erhält ein Client, der sich mit since=<message ID> erneut verbindet, auch Nachrichten, die in derselben Sekunde veröffentlicht wurden. Dadurch kann er eine Nachricht doppelt sehen. Die ntfy-Apps und die Webanwendung entfernen Duplikate anhand der Nachrichten-ID. Ein eigenes Skript, das ein Thema erneut abspielt, muss dies ebenfalls tun. Jeder Dienst auf dem Server hat eine eigene kurze Liste von Pfaden, die nicht neu erzeugt werden können. Der Vergleich von PhotoPrism und Immich ermittelt diese Liste sowie die zugehörigen Backup-Befehle für eine Fotobibliothek auf einem VPS derselben Art.

Gotify und Apprise

Gotify ist die kleinere Option: eine einzelne Binärdatei mit Weboberfläche und Android-App. Die Nachrichten sind nach Anwendungen organisiert. Das eignet sich für einen privaten Server, wenn Android das einzige Ziel ist. Apprise ist eine Python-Bibliothek und ein Kommandozeilenprogramm. Zusätzlich ist ein separater Apprise-API-Server verfügbar. Damit lässt sich eine einzelne Nachricht an mehr als hundert Dienste verteilen, einschließlich ntfy. Das eignet sich für ein Skript, das mehrere Ziele gleichzeitig erreichen muss. ntfy stellt einen Server, eine HTTP-API und Apps für beide mobilen Plattformen bereit. Deshalb ist ntfy die übliche Lösung für Benachrichtigungen von einem gemieteten Server.

FAQ

Warum wird die Veröffentlichung auf meinem ntfy-Server mit 403 abgewiesen?

Mit auth-default-access: "deny-all" in server.yml wird eine anonyme Veröffentlichung abgewiesen. Das ist das beabsichtigte Verhalten. Senden Sie Anmeldedaten mit -u user:pass oder -H "Authorization: Bearer tk_...". Wenn Sie bereits ein Token senden und trotzdem 403 erhalten, prüfen Sie, ob für den zugehörigen Benutzer ein ACL-Eintrag vorhanden ist, der Schreibzugriffe auf das Topic erlaubt: Kein passender Eintrag, read-only oder deny weist die Veröffentlichung ab. In v2.34.0 konnten gleichzeitige Anfragen von derselben IP-Adresse außerdem dazu führen, dass gültige Anmeldedaten als anonym behandelt wurden. v2.35.0 behebt diesen Fehler. Führen Sie daher zuerst ein Upgrade durch, bevor Sie ein sporadisches 403 als Beleg für ein ACL-Problem werten. Führen Sie ntfy access aus, um die vollständige Liste auszugeben. Beachten Sie, dass eine write-Berechtigung kein Abonnieren erlaubt. Ein Konto, das problemlos veröffentlicht, wird daher weiterhin abgewiesen, wenn es versucht, dasselbe Topic zu lesen.

Funktionieren Benachrichtigungen auf dem iPhone mit einem selbst gehosteten ntfy-Server?

Bei Verwendung der offiziellen iOS-App funktionieren sie über ein Relay. Das Aufwecken einer angehaltenen iPhone-App muss über APNs (Apple Push Notification service) erfolgen. Für das Senden an die offizielle App werden die Push-Anmeldedaten des Herausgebers benötigt. Daher leitet ntfy ein poll_request mit der Nachrichten-ID an ntfy.sh weiter. ntfy.sh leitet es anschließend an das Gerät weiter. Setzen Sie upstream-base-url: "https://ntfy.sh" in server.yml und starten Sie den Container neu. Der Nachrichtentext selbst wird weiterhin von Ihrem Server abgerufen. Ohne diese Einstellung treffen iOS-Benachrichtigungen weiterhin ein, aber laut ntfy-Dokumentation kann die Verzögerung mehrere Stunden betragen. Die PWA bietet unter iOS 16.4 oder höher eine weitere Möglichkeit, wenn Web Push auf Ihrem Server konfiguriert ist.

Warum ist die ntfy-Benachrichtigung meines Cronjobs nie eingetroffen?

Führen Sie die curl-Zeile zunächst allein aus, um zu prüfen, ob Token und Topic korrekt sind. Wenn sie manuell funktioniert, aber nicht aus cron, liegt der Fehler vor der Benachrichtigung: cron führt Jobs mit einer minimalen Umgebung und einem kurzen PATH aus. Daher kann ein Skript beendet werden, bevor es die curl-Zeile erreicht, wenn es einen Befehl über seinen unqualifizierten Namen aufruft. Verwenden Sie absolute Pfade, leiten Sie die Ausgabe des Jobs in eine Logdatei um und lesen Sie diese Datei nach dem nächsten Lauf. Eine 429-Antwort statt einer Zustellung bedeutet, dass ein Limit die Anfrage abgewiesen hat. Meist versucht das Skript, zu schnell erneut zu senden. Auch ein Besucher, der ein Tageskontingent ausgeschöpft hat, beispielsweise das oben festgelegte Nachrichtenlimit, wird selbst bei einer einzelnen Anfrage auf dieselbe Weise abgewiesen.

Sollte ich ntfy im öffentlichen Internet bereitstellen?

Die Smartphone-Apps müssen ntfy aus Mobilfunknetzen erreichen können. Daher ist ein öffentlicher HTTPS-Endpunkt mit auth-default-access: "deny-all" und ACLs pro Topic die übliche Konfiguration. Sie ist sicher, solange kein Topic für everyone lesbar ist. Eine ausschließlich über VPN erreichbare Instanz ist sinnvoll, wenn jeder Abonnent ein von Ihnen kontrollierter Computer ist. Für Smartphones ist sie schlecht geeignet, weil die App nur bei bestehendem Tunnel Nachrichten empfängt. Benachrichtigungen werden daher zurückgehalten, bis das Smartphone wieder eine Verbindung herstellt.

War dieser Artikel hilfreich?