How-To Series · 5: Everywhere You Are

ntfy Push

The lightest push channel for Hermes. Subscribe to a topic, message it, get replies as notifications.

After this videoYou can talk to your Hermes agent from your phone with no SDK and no daemon

ntfy is a simple HTTP pub-sub notification service. You pick a topic name, subscribe to it in the ntfy mobile app, and set NTFY_TOPIC, NTFY_ALLOWED_USERS, and NTFY_HOME_CHANNEL in Hermes, all usually the same topic. The adapter uses httpx, already a dependency, so there is no SDK or daemon. ntfy has no native identity, so the topic name is the identity. Lock the topic down by self-hosting, using a token, or picking a long unguessable name. Messages cap at 4096 characters with no threads or attachments.

About these resources. This episode explains how to set up ntfy in Hermes. The Sources block names the Hermes docs page that backs every claim.

Sources · What this video distills

1 docs page · every command below traces to one of them
Primary guide
ntfy
Read ↗

Commands shown · Copy and paste

each shows the source doc it came from
Configure ntfy in Hermesfrom source ↗
hermes gateway setup
Restart the gatewayfrom source ↗
hermes gateway restart
Self-host an ntfy serverfrom source ↗
docker run -p 80:80 -it binwiederhier/ntfy serve

Going deeper · Related Hermes docs

further reading · not sources of facts shown above

Next in the series · Episodes that build on this