1
0
mirror of https://github.com/vimagick/dockerfiles.git synced 2024-12-23 01:39:27 +02:00
dockerfiles/ntfy/README.md
2024-09-24 17:47:10 +08:00

50 lines
1.2 KiB
Markdown

ntfy
====
[ntfy][1] (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
```bash
$ 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
```yaml
default-host: http://127.0.0.1:2586
default-user: kev
default-password: "******"
#default-token: "******"
```
```bash
$ ntfy sub test
$ ntfy pub -T fire -t WARNING test "Fire in the Hole"
```
```bash
$ 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
```
[1]: https://docs.ntfy.sh/config/