Ntfy
Lightweight push notification service for scripts, servers and applications, usable from HTTP, CLI, web or mobile.
Overview
Ntfy lets you send notifications from a script, server, application or automation tool, then receive them in a web interface, mobile app or compatible client. It is useful for simple alerts without deploying a heavy notification platform.
The service is based on ntfy, a free software project that keeps the model simple: publish a message to a topic and subscribe to that topic from another device or tool.
Quick facts
| Service URL | ntfy.hostux.net |
|---|---|
| Service type | Push notification service |
| Free software used | ntfy |
| Project website | ntfy.sh |
| Source code | github.com/binwiederhier/ntfy |
| Account required | No for simple use |
Why use Ntfy
- Receive simple alerts from scripts or servers.
- Use HTTP, CLI, web or mobile clients.
- Keep notifications easy to integrate in automation.
- Avoid relying on a proprietary push notification stack for simple needs.
Main features
- Publish messages to topics with HTTP requests.
- Subscribe from web, mobile apps, CLI or API clients.
- Use priorities, tags and attachments depending on the client and configuration.
- Integrate with monitoring, backup and automation scripts.
How the service works
- You pick a topic, which acts as a notification channel.
- You publish a message to that topic with an HTTP request or via the ntfy client.
- Subscribers to the topic then receive the notification on the web, on mobile or via a subscription API.
- On an open service, the topic effectively acts as a secret: it is best to choose a name that is hard to guess.
- Depending on the instance configuration, some topics may also be protected by authentication or access rules.
Use cases
- Backup or cron job notifications.
- Monitoring alerts from a server.
- Small automation messages from scripts.
- Simple push notifications between devices.
Usage examples
Ntfy can be used very simply from a script, terminal or application. The principle stays the same: publish a message to a topic, then subscribe to it from the client of your choice.
curl -d "Backup completed" https://ntfy.hostux.net/my-topiccurl -H "Title: Backup" -H "Priority: high" -d "Backup failed" https://ntfy.hostux.net/my-topicntfy publish my-topic "Deployment finished"curl -s https://ntfy.hostux.net/my-topic/jsoncurl -s https://ntfy.hostux.net/my-topic/sse
This service integrates well with uses such as backup notifications, scheduled-task alerts, change detection on a website or messages sent by an automation tool.
The ntfy ecosystem also documents concrete integrations with tools like Changedetection.io, Watchtower, GitHub Actions, Node-RED, Home Assistant or Uptime Kuma, depending on your usage.
Access the service
Service: ntfy.hostux.net