You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.6 KiB
1.6 KiB
Podman Quadlet: ntfy
Overview
ntfy is a simple HTTP-based pub-sub notification service started as a Podman Quadlet. It lets you send push notifications to your phone or desktop via scripts from any computer.
This cookbook:
- Runs ntfy as a rootless container with minimal privileges (UID 10027).
- Uses PostgreSQL as the database backend (requires the
postgresqlcookbook). - Stores attachment cache on virtiofs (
/var/lib/virtiofs/data/ntfy). - Exposes ntfy through Traefik (requires the
traefikcookbook). - Includes health checks to monitor the service status.
- Supports automatic container image updates via Podman auto-update.
Prerequisites
- The
postgresqlcookbook must be installed and running. - The
traefikcookbook must be installed and running. - The
basecookbook must be installed (provides the virtiofs mount). - Configuration file
/etc/quadlets/ntfy/server.ymlmust exist.
Usage
Copy and customize the example configuration:
sudo cp config/examples/server.yml /etc/quadlets/ntfy/server.yml
sudo vi /etc/quadlets/ntfy/server.yml
In a separate terminal, follow the logs:
sudo make tail-logs
Install the Podman Quadlets and start ntfy:
sudo make clean install
You should see the ntfy.service waiting for PostgreSQL to be available, then starting up.
Verify ntfy is running:
curl -sSf http://127.0.0.1:8080/v1/health
Restart the ntfy.target unit:
sudo systemctl restart ntfy.target
Finally, remove the quadlets, their configuration and their data:
sudo make uninstall clean