selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

ntfy logo

Self-host ntfy

v2.38.1

HTTP-based pub-sub push notification service

ReleaseOpen SourceApache-2.0
Updated2 hours ago
LanguageGo
Setup difficultyEasy
MobileNative app
Stars
35 587
Ports
80 (HTTP web server and API), 443 (HTTPS web server (when configured)), 25 (SMTP server for incoming email (when enabled))
Docker
binwiederhier/ntfy
Install with Docker
Terminal showing curl command to send a notificationWeb app showing notification detail viewAndroid app main screen with topic listAndroid app notification detail viewAndroid phone showing received notificationWeb app desktop notification viewPhone app main screen with topicsPhone app notification detail with priority and actionsPhone app showing file attachment in notification

What is ntfy?

ntfy delivers push notifications to phones and desktops through simple HTTP requests — just POST a message to a topic and subscribers get it instantly. It handles priorities that map to distinct sounds and vibration patterns, file attachments up to configurable limits, interactive action buttons, and tags/emojis for organization. A browser-based web app shows desktop notifications, while native Android and iOS apps provide mobile push. The server integrates with Home Assistant, Healthchecks.io, changedetection.io, and dozens of other tools, plus it speaks UnifiedPush for Android clients. Self-hosting options span Docker, pre-built binaries, system packages (Debian, RPM, Arch, Nix, FreeBSD), and Kubernetes. Written in Go, it defaults to SQLite with optional PostgreSQL, and is dual-licensed Apache 2.0 / GPLv2.

ntfy alternatives

Should you self-host ntfy?

ntfy scores 85/100 on selfhost.directory (how scoring works) and ranks #1 of 20 in Notifications. It has 35 587 GitHub stars, +810 in the last 30 days.

It shipped 29 stable releases in the past year. The latest, v2.38.1, came out on 16 November 2026. New versions land roughly every 5 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Novu (77/100, 40 341 stars). ntfy scores higher overall. See ntfy vs Novu side by side.

Features

  • Access Control (ACL)
  • Action Buttons
  • CLI Client
  • Email notifications
  • File attachments
  • Message cache with since/poll
  • Message priorities
  • Phone call notificationsRequires Twilio account
  • Pub-sub topic model
  • Push notifications via HTTP PUT/POST
  • REST API
  • Tags and emojis
  • UnifiedPush support
  • Web app for desktop notifications
  • Web Push (browser push API)

ntfy README

ntfy

ntfy.sh | Send push notifications to your phone or desktop via PUT/POST

Release Go Reference Tests Go Report Card codecov Discord Matrix Matrix space Healthcheck Gitpod

ntfy (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. If you'd like to run your own instance of the service, you can easily do so since ntfy is open source.

How to install ntfy

Install ntfy with Docker

Docker Engine
Environment variables
NTFY_BASE_URL, NTFY_LISTEN_HTTP, NTFY_CACHE_FILE, NTFY_AUTH_FILE, etc.

docker run -p 80:80 -it binwiederhier/ntfy serve

Official image on Docker Hub for amd64, armv6, armv7, arm64

How to configure ntfy

  • base-urlPublic facing base URL of the service (e.g. https://ntfy.sh)

    values: URL

  • listen-http:80Listen address for the HTTP web server

    values: [host]:port

  • listen-httpsListen address for the HTTPS web server

    values: [host]:port

  • cache-fileSQLite database file for message cache

    values: filename

  • cache-duration12hDuration for which messages will be buffered before deletion

    values: duration

ntfy releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

If topic names are public, could I not just brute force them?

Topic names act as passwords. Random names are secure. Rate limiting prevents brute forcing (60 requests burst, then 1 per 10 seconds).

Can I disable the web app? Can I protect it with a login screen?

The web app is a static site with no backend risk. Can be disabled with web-root: disable or require login with require-login: true.

I'm having issues with iOS, can you help? The iOS app is behind compared to the Android app, can you fix that?

The iOS app is bare-bones and buggy; development was paused. Known issues are documented.

Can you implement feature X?

Check existing GitHub issues first, then file a new issue. The maintainer typically responds within a few days.

What is instant delivery?

Android app feature maintaining a constant server connection for instant notification delivery, consuming extra battery.

Paid plans? I thought it was open source?

All of ntfy remains open source (Apache 2.0 / GPLv2). Paid plans are for those who don't want to self-host and need higher limits.

How much battery does the Android app use?

Without instant delivery, no additional battery (uses FCM). With instant delivery or self-hosted/F-Droid, about 0-1% per 17 hours.

Is Firebase used?

Messages are published to Firebase Cloud Messaging (FCM) on ntfy.sh for Android push. Self-hosted instances can disable this.

Can I self-host it?

Yes, the server including the web UI can be self-hosted, and the mobile apps support custom servers.

Will you know what topics exist, can you spy on me?

Topic names and IPs are logged for troubleshooting and rate limiting. For sensitive messages, self-host.

What happens if there are multiple subscribers to the same topic?

All subscribers receive the notification, as per standard pub-sub behavior.

What are the uptime guarantees?

Best effort only. The service runs on a single DigitalOcean droplet without redundancy.

Can I use this in my app? Will it stay free?

Yes, ntfy.sh is free to use without signup as long as you don't abuse it. Paid plans may be offered for higher limits.

Isn't this like ...?

The author didn't do extensive research before creating ntfy; it was built for fun.

More in Notifications

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…