ntfy

ntfy (pronounced "notify") is a simple HTTP-based pub-sub notification service. With ntfy, you can send notifications to your phone or desktop via scripts from any computer, without having to sign up or pay any fees.

up and running

$ mkdir -p data/{etc,log,var}
$ docker compose up -d
$ docker compose exec nify sh
>>> ntfy user add pi
>>> ntfy user add --role=admin kev
>>> ntfy user list
>>> ntfy access pi test rw
>>> ntfy access '*' test ro
>>> ntfy access
>>> ntfy token add --expires=30d --label=pi5 pi
>>> ntfy token add --expires=90d --label=win kev
>>> ntfy token list
>>> exit
$ curl http://127.0.0.1:2586

client setup

Linux: ~/.config/ntfy/client.yml
MacOS: ~/Library/Application Support/ntfy/client.yml

default-host: http://127.0.0.1:2586
default-user: kev
default-password: "******"
#default-token: "******"

$ ntfy sub test
$ ntfy pub -T fire -t WARNING test "Fire in the Hole"

$ websocat --basic-auth "kev:******" ws://127.0.0.1:2586/test/ws
$ curl -u "kev:******" -H 'Tags: fire' -H 'Title: WARNING' -d 'Fire in the Hole' http://127.0.0.1:2586/test