Self-host ntfy
v2.38.1HTTP-based pub-sub push notification service
- Stars
- 35 587
- Ports
- 80 (HTTP web server and API), 443 (HTTPS web server (when configured)), 25 (SMTP server for incoming email (when enabled))
binwiederhier/ntfyWhat 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
iGotify-Notification-AssistentSelf-hosted bridge forwarding Gotify notifications to iOS via Apple's push service and SecNtfy, with end-to-end encryption and a native iOS app.CompareiGotify-Notification-Assistent with ntfy
notifkitSelf-hosted notification engine sending across channels with user preferences, timing rules, retries, fallback, scheduling, workflows, dashboard, and delivery tracking.Comparenotifkit with ntfy
release-notifierSelf-hosted tool that monitors GitHub releases for Docker containers, summarizes changelogs with AI, and sends push notifications via ntfy and Home Assistant.Comparerelease-notifier with ntfy
subscription-managerSelf-hosted web app to track subscriptions, view payment calendars, calculate totals, and get notified via NTFY or Gotify. Open-source with Docker deployment.Comparesubscription-manager with ntfy
PlatypushPlatypush is a self-hosted, open-source automation platform connecting hundreds of devices and services with event-driven routines, web UI, dashboards, and mobile access.ComparePlatypush with ntfy
apprise-apiSelf-hosted, open-source REST notification hub wrapping the Apprise library to push alerts to 150+ services, with a web config manager, tags, attachments and Basic Auth.Compareapprise-api with ntfy
NutifyOpen-source, self-hosted UPS monitoring built on Network UPS Tools: live status, historical telemetry, alerts via mail, Ntfy, Telegram or webhooks, scheduled reports.CompareNutify with ntfy
notifuseOpen-source, self-hosted newsletter, email marketing and transactional email platform. Visual MJML editor, Liquid templating, 7 sending providers.Comparenotifuse with ntfy
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 (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.
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
ObicoObico Server is the self-hostable backend of the open-source Obico 3D printing platform: remote monitoring, streaming and AI failure detection for OctoPrint/Klipper.
OctoboxOpen-source, self-hosted notification inbox for GitHub: archive, star, mute and filter threads, with Gmail-style keyboard shortcuts, search prefixes and a REST API.
OperationalSelf-hosted event tracking tool for tech products that sends push notifications for critical events like signups, cronjobs, and webhooks.
Operational.coOperational - open-source tool to track important events and receive push notifications on your device.
prom-alertmanagerOpen-source Prometheus alert hub: deduplicates, groups, routes and silences alerts to Slack, PagerDuty, email or webhooks; self-hosted with a Docker image or binaries.
release-feeds-to-discordSelf-hosted Python app that polls RSS and Atom release feeds on a schedule and posts each new entry to a Discord webhook, with a web UI for managing feeds.
Signal-APISelf-hosted, open-source Docker container that wraps signal-cli as a REST API, so scripts can register a Signal number and send, receive and manage messages.
TautulliTautulli is a self-hosted, open-source Python web app that monitors Plex Media Server, providing analytics, watch history, and customizable notifications.
tautulli-notification-digestSelf-hosted tool that consolidates Tautulli's 'Recently Added' events into scheduled Discord digest notifications, replacing individual alerts with timed summaries.
uptime-kumaSelf-hosted, open-source uptime monitoring for HTTP(s), TCP, DNS, Docker with reactive UI, 20s intervals, status pages, and 90+ notification channels.
apprise-apiSelf-hosted, open-source REST notification hub wrapping the Apprise library to push alerts to 150+ services, with a web config manager, tags, attachments and Basic Auth.
Barkbark-server is a self-hosted open-source push notification backend for iOS devices via Apple APNs. Replace the cloud Bark service with full privacy control.










0 comments