ntfy
Send notifications to your phone or desktop via scripts from any computer, and/or using a REST API
ntfy LLC



ntfy (pronounced notify) is a simple HTTP-based pub-sub notification service. It allows you to send notifications to your phone or desktop via scripts from any computer, and/or using a REST API.
ℹ️ iOS Notifications Apple's restrictions require a publicly reachable server for instant notifications on iOS. We use https://ntfy.sh for poll requests by default. This doesn't send your notifications through this service, but instead only prompts your iOS device to download the notification from your local ntfy instance. Advanced users can remove the "NTFY_UPSTREAM_BASE_URL" environment variable from the Docker compose file if desired; however, this will disable instant notifications on iOS devices.
🔔 Send push notifications from your app or script Publishing messages can be done via PUT or POST. Topics are created on the fly by subscribing or publishing to them. If you use ntfy without sign-up, the topic is essentially a password, so pick something that's not easily guessable.
📱 Receive notifications on your phone Subscribe to a topic and receive notifications, with different priorities, attachments, action buttons, tags & emojis, and even for automation.
💻 Get notified on your computer You can use the web app to subscribe to topics as well. If you do, notifications will pop up as desktop notifications. Simply type in the topic name and click the Subscribe button. The browser will keep a connection open and listen for incoming notifications.
⚙️ Integrate with your favorite tools Publishing messages is just a HTTP request, so pretty much everything under the sun can integrate with ntfy. Hundreds of integrations, projects or scripts already support ntfy.
This release adds support for templating in the priority field, a new copy action button, a red notification dot on the favicon for unread messages, and an admin-only version endpoint.
Key highlights:
- Support templating in the priority field
- Copy action button to copy values to the clipboard
- Red notification dot on favicon when there are unread messages
- Admin-only version endpoint returning server version and build information
- Several crash fixes and web app improvements
Full release notes can be found at https://github.com/binwiederhier/ntfy/releases
This release adds support for updating and deleting notifications, heartbeat-style notifications, custom Twilio call format, and makes ntfy work on Windows.
Key highlights:
- Update and delete notifications after they've been sent
- Heartbeat-style notifications for monitoring services
- Custom Twilio call format configuration
- Windows support including running as a Windows service
- New version available banner in the web app
Full release notes can be found at https://github.com/binwiederhier/ntfy/releases
This release adds a new feature that allows you to require users to log in before they can use the web app.
Key highlights:
- New require-login flag to redirect to login page if not logged in
- Bug fixes and maintenance improvements
Full release notes can be found at https://github.com/binwiederhier/ntfy/releases
This release brings new features, various bug fixes and performance improvements.
Key highlights:
- Declarative users, ACL entries, and tokens in config file
- Pre-defined and custom templates for JSON webhook support
- Advanced template functions based on the Sprig library
- Full IPv6 support
- Improved proxy header support for rate limiting
Full release notes can be found at https://github.com/binwiederhier/ntfy/releases
This release includes various bug fixes and performance improvements.
Full release notes can be found at https://github.com/binwiederhier/ntfy/releases
This release includes new features and bug fixes:
- Added username/password authentication for email publishing
- Introduced a 'latest' subscription parameter to retrieve the most recent message
- Added support for changing passwords via the v1/users API
- Increased the default WebPush subscription warning/expiry to 55/60 days
- Added support for systemd user service 'ntfy-client.service'
- Fixed iOS delivery issues for read-protected topics
- Improved IP address parsing when behind a proxy
- Made Markdown in the web app scrollable horizontally
- Increased the number of access tokens per user to 60
Full release notes can be found at https://github.com/binwiederhier/ntfy/releases
