ntfy: Simple Push Notifications to Your Phone or Desktop via PUT/POST

Summary
ntfy is an open-source, HTTP-based pub-sub notification service that allows users to send push notifications to their phones or desktops. It offers a free public instance, self-hosting options, and dedicated mobile apps for Android and iOS, making it a versatile tool for script-based alerts.
Repository Info
Tags
Click on any tag to explore related repositories
Introduction
ntfy (pronounced "notify") is a powerful, open-source, HTTP-based pub-sub notification service designed to send push notifications to your phone or desktop. It enables developers and users to easily integrate alerts into scripts, cron jobs, or any application using simple PUT/POST requests, without the need for complex APIs or third-party services. With ntfy, you can receive timely updates directly on your devices.
Installation
Getting started with ntfy is straightforward. You can use the free public instance available at ntfy.sh or choose to self-host your own instance for complete control over your notifications. Detailed installation instructions for various platforms and self-hosting options can be found in the official documentation.
For comprehensive installation guides and self-hosting details, visit the ntfy documentation.
Examples
Sending a notification with ntfy is as simple as a curl command. Here’s a basic example:
curl -d "Hello world" ntfy.sh/mytopic
After executing this command, any device subscribed to the mytopic topic will receive a "Hello world" push notification. This simplicity makes ntfy incredibly versatile for various automation and alerting needs.
Why Use ntfy?
ntfy stands out for several compelling reasons:
- Simplicity and Ease of Use: Integrate notifications into your workflows with minimal effort using standard HTTP requests.
- No Sign-up or Fees: The public instance allows you to send notifications without creating an account or incurring costs.
- Self-Hostable: For those who require maximum privacy and control, ntfy can be easily self-hosted on your own infrastructure.
- Cross-Platform Support: Receive notifications on Android, iOS, and desktop browsers through dedicated apps and a web interface.
- Open Source: The entire project, including server and client apps, is open source, fostering transparency and community contributions.
Links
- GitHub Repository: https://github.com/binwiederhier/ntfy
- Official Website: https://ntfy.sh
- Documentation: https://ntfy.sh/docs/
- Android App (Google Play): https://play.google.com/store/apps/details?id=io.heckel.ntfy
- iOS App (App Store): https://apps.apple.com/us/app/ntfy/id1625396347