Self-Hosted / Projects / ntfy

ntfy
StableSpecs verified September 14, 2026 · against vv2.28.0
Overview
Self-hosted push notification server with HTTP publishing, topic subscriptions, and mobile apps.
ntfy is an open-source push notification service that lets scripts and applications send alerts to phones or desktops through simple HTTP PUT or POST requests. Self-hosting the ntfy server gives a homelab or private infrastructure control over topics, authentication, message history, attachments, and delivery configuration.
Why people choose ntfy
The useful alternative intent is usually “self-hosted Pushbullet or Pushover alternative” rather than the brand name alone. ntfy keeps the publishing interface simple while offering mobile apps, a web UI, CLI access, topic subscriptions, priorities, tags, action buttons, and message attachments.
What is included
The official docs cover a statically linked server, Docker image and packages for amd64, armv7, and arm64, HTTP publishing and subscribing, Android/iOS apps, a web interface, access control, message caching, attachments, web push, SMTP publishing, Firebase delivery for the public service, and Prometheus metrics.
Requirements and tradeoffs
A basic server can run as one ntfy process with file-backed cache and attachment storage; PostgreSQL is an optional configuration for deployments that need it. You must choose a public base URL, protect topics with authentication and access rules, persist cache and attachment data, and use TLS or a correctly configured reverse proxy. Topic names are public by default on the public service, so do not treat an unprotected topic as a private channel.
Best fit
Choose ntfy when you need lightweight alerts from backups, monitoring, scripts, or home automation without adopting a larger notification platform. If you need guaranteed mobile delivery semantics, complex workflow orchestration, or a managed service with no operational work, compare it with hosted providers or a broader automation stack.
Feature support
| Feature | Support |
|---|---|
| HTTP PUT and POST publishingOfficial docs show publishing messages through HTTP PUT or POST requests. | Supported |
| Phone and desktop subscriptionsThe official project provides phone apps and supports desktop/browser subscriptions. | Supported |
| Topic-based pub-subSubscribers choose a topic and publishers send messages to that topic. | Supported |
| CLI publishing and subscribingThe ntfy CLI can publish and subscribe in addition to the HTTP API. | Supported |
| Message priorities, tags, and actionsThe official docs list priorities, action buttons, icons, tags, and emojis. | Supported |
| Authentication and access controlServer configuration includes users, access rules, and a deny-all default option. | Supported |
| Caching and attachmentsThe server supports a message cache and attachment cache that should be persisted. | Supported |
| Docker and ARM packagesOfficial installation docs provide a Docker image and packages for amd64, armv7, and arm64. | Supported |
| PostgreSQL backendPostgreSQL is documented as an optional configuration; the simple setup can use file-backed storage. | Partial support |
| Prometheus metricsMetrics are available when enabled and configured, rather than being the default user-facing feature. | Partial support |
Community signals
- Stars
- 34.9k
- Forks
- 1.7k
- Open issues
- 348
- Last commit
- 1d ago
- Latest release
- v2.31.0
- Repo created
- Oct 2021
Includes open pull requests
1d ago
Refreshed nightly from the GitHub API.
Questions
What is ntfy used for?
ntfy is used to send push notifications from scripts, apps, monitoring jobs, and automation to phones or desktops through HTTP or the ntfy CLI.
Can you self-host ntfy?
Yes. The official installation docs describe running your own server as a binary, package, or Docker image.
Is ntfy a self-hosted Pushover or Pushbullet alternative?
It can fill that lightweight alerting role, but delivery behavior and mobile integrations differ. ntfy is particularly attractive when you want an open-source server and a simple HTTP publishing API.
Does ntfy need a database?
No separate database is required for the basic file-backed setup. The official configuration also documents PostgreSQL as an optional backend for some deployments.
What platforms does ntfy support?
The server supports common Linux architectures including amd64, armv7, and arm64, and the project provides Android, iOS, web, and CLI subscription or publishing paths.
Are ntfy topic names private?
Not automatically. The official getting-started docs warn that topic names on ntfy.sh are public and should be difficult to guess; self-hosters should configure authentication and access rules for private notifications.
Can ntfy run in Docker?
Yes. The official docs provide a Docker image and Docker Compose configuration examples with persistent cache, auth, and attachment paths.
support // the lab
Found this write-up useful?
If it saved you time or a rebuild, you can support more practical homelab guides.