ntfy — Leichte Push-Benachrichtigungen

Hast du dir je gewünscht, dass dein Handy dich benachrichtigt, sobald ein Skript fertig ist – ohne eine einzige App zu installieren? Das ist der Alltagszauber von ntfy: Es verwandelt jedes Thema in einen Pub-Sub-Kanal, den du mit einer simplen HTTP-Anfrage anpingen kannst.

Für Hermes-Agent-Nutzer ist ntfy der einfachste Weg, deinen KI-Agenten in der Hosentasche zu tragen. Kein SDK, kein Daemon, kein Node.js – nur ein Themenname und die kostenlose ntfy-Mobile-App. So verdrahtest du alles.

Warum ntfy wie angegossen zu Hermes passt

Hermes steht für leichte Automatisierung. ntfy passt perfekt zu dieser Philosophie:

Null Abhängigkeiten – der Adapter nutzt httpx, das bereits in Hermes enthalten ist.
Jeder HTTP-Client funktioniert – curl, Python, sogar eine Smartwatch.
Selbst hostbar – betreibe deinen eigenen ntfy-Server für private Themen oder nutze den kostenlosen öffentlichen Dienst ntfy.sh.

Du abonnierst ein Thema auf deinem Handy, sendest eine Nachricht an dieses Thema von Hermes aus und erhältst die Antwort als Benachrichtigung. Push-Messaging ohne Ballast.

Schnellstart: Setup-Assistent

Der schnellste Weg führt über die geführte Einrichtung:

hermes gateway setup

Wähle ntfy aus dem Menü, gib deinen Themennamen ein (z. B. hermes-myname-2026), und fertig. Der Assistent schreibt die Konfiguration in ~/.hermes/.env.

Manuelle Konfiguration über Umgebungsvariablen

Du bearbeitest lieber Dateien? Füge Folgendes zu ~/.hermes/.env hinzu:

NTFY_TOPIC=hermes-myname-2026
NTFY_ALLOWED_USERS=hermes-myname-2026
NTFY_HOME_CHANNEL=hermes-myname-2026

Das ist das Minimum. Hier siehst du, was jede Variable bewirkt:

Variable	Erforderlich	Zweck
`NTFY_TOPIC`	Ja	Thema, das abonniert wird (eingehende Nachrichten)
`NTFY_SERVER_URL`	Nein	Standard `https://ntfy.sh`; für Privatsphäre auf selbst gehosteten Server zeigen
`NTFY_TOKEN`	Nein	Bearer-Token (`tk_xyz`) oder `user:pass` für die Authentifizierung
`NTFY_PUBLISH_TOPIC`	Nein	Separates Thema für Antworten (Standard: `NTFY_TOPIC`)
`NTFY_MARKDOWN`	Nein	Auf `true` setzen, um Antworten mit `X-Markdown: true` zu senden
`NTFY_ALLOWED_USERS`	Empfohlen	Kommagetrennte Themennamen, die als Benutzer-IDs behandelt werden
`NTFY_ALLOW_ALL_USERS`	Nein	Erlaubt jedem Publisher den Zugriff – nur bei privaten Themen sicher
`NTFY_HOME_CHANNEL`	Nein	Standardthema für Cron / Benachrichtigungen
`NTFY_HOME_CHANNEL_NAME`	Nein	Verständliche Bezeichnung für den Home-Channel

Das Identitätsmodell: Vor dem Deployment lesen

Hier ist der Haken bei ntfy: Es gibt keine echten Benutzerkonten. Das Feld title einer Nachricht wird vom Publisher kontrolliert – jeder kann es fälschen. Deshalb nutzt Hermes title nicht für die Autorisierung.

Stattdessen ist der Themenname selbst die Identität. Jede Nachricht auf dem Thema wird so behandelt, als käme sie vom selben logischen Benutzer. NTFY_ALLOWED_USERS ist in der Regel einfach der Themenname selbst – eine Whitelist mit einem einzigen Eintrag.

Sicherheitsimplikation: Jeder, der dein Thema kennt, kann mit deinem Agenten sprechen. Um daraus eine echte Vertrauensgrenze zu machen:

Hoste ntfy selbst und schütze das Thema mit Access Control.
Nur autorisierte Clients können publizieren oder abonnieren.

Ein praktischer Tipp für den Alltag

Setze NTFY_MARKDOWN=true, wenn du formatierte Antworten (fett, Listen, Codeblöcke) möchtest, die in der ntfy-App sauber dargestellt werden. Das macht lange Agentenantworten auf dem Handybildschirm viel leichter lesbar.

Fazit

ntfy gibt Hermes einen denkbar einfachen Push-Kanal: Auf dem Handy abonnieren, drei Umgebungsvariablen konfigurieren, fertig. Kein Cloud-Konto, keine Zusatzdienste, keine Lernkurve.

Letzter Tipp: Starte mit einem eindeutigen Thema wie hermes-<deinname>-<jahr> – das ist auf dem öffentlichen Server praktisch kollisionssicher. Sobald du dem Workflow vertraust, hoste ntfy selbst und füge Access Control hinzu, für einen wirklich privaten Kanal. Dein Agent ist jetzt nur noch ein Buzz entfernt.