New: run your homelab, smart home and subscriptions from Notion. All 3 templates for $29, not $42Save $13GET ALL THREE

Homelab Addiction

Self-Hosted / Projects / ntfy

Specs 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 in ntfy
FeatureSupport
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

Includes open pull requests

Last commit
1d ago
Latest release
v2.31.0

1d ago

Repo created
Oct 2021

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.

Support the lab