ntfy — Simple Push Notifications via HTTP PUT/POST
ntfy (notify) lets you send push notifications to your phone or desktop using simple HTTP requests. No app registration, no API keys — just curl a URL.
What it is
ntfy (pronounced 'notify') is a push notification service that lets you send messages to your phone or desktop using simple HTTP PUT or POST requests. There is no app registration, no API keys, and no complex setup. You pick a topic name and send a message to it.
DevOps engineers, hobbyists, and anyone who needs simple alerting from scripts, cron jobs, or CI pipelines will find ntfy the fastest path to push notifications.
How it saves time or tokens
ntfy eliminates the overhead of configuring email servers, Slack webhooks, or dedicated notification services. A single curl command sends a notification. The hosted instance at ntfy.sh is free for basic use, and you can self-host for full control.
How to use
- Install the ntfy app on your phone (Android/iOS) or use the web client.
- Subscribe to a topic of your choice.
- Send notifications via curl or any HTTP client.
# Send a notification
curl -d 'Backup completed successfully' ntfy.sh/my-alerts
# Send with a title and priority
curl -H 'Title: Deploy Status' \
-H 'Priority: high' \
-H 'Tags: rocket' \
-d 'Production deploy finished' \
ntfy.sh/my-deploys
Example
Notify yourself when a long-running script finishes:
#!/bin/bash
# backup.sh
tar -czf /backups/data-$(date +%F).tar.gz /data
curl -d "Backup finished at $(date)" ntfy.sh/my-backups
Related on TokRepo
- Self-hosted tools — Privacy-focused self-hosted services
- Automation tools — Workflow and task automation tools
Common pitfalls
- Topic names on ntfy.sh are public. Anyone who knows the topic name can subscribe. Use random topic names or self-host for privacy.
- Free tier on ntfy.sh has rate limits. Self-host if you send high volumes of notifications.
- Mobile notifications require the ntfy app to be running in the background. Battery optimization settings may delay delivery.
Frequently Asked Questions
The hosted service at ntfy.sh is free for basic use with rate limits. The software is open-source and you can self-host your own instance with no usage restrictions.
No. ntfy requires no registration or API keys for basic use. You simply pick a topic name and start sending. For authentication on self-hosted instances, you can optionally configure user/password access control.
Yes. ntfy is a single Go binary that you can run on any server. It supports Docker deployment and requires minimal configuration. Self-hosting gives you full control over data, rate limits, and access.
Yes. ntfy supports file attachments, click actions, and inline images in notifications. You can attach files up to a configurable size limit via the HTTP API.
ntfy has apps for Android (Google Play and F-Droid), iOS, and a web client. You can also receive notifications via email or websocket for custom integrations.
Citations (3)
- ntfy GitHub— ntfy sends push notifications via HTTP PUT/POST with no API keys
- ntfy Documentation— Supports Android, iOS, and web clients
- ntfy Installation Docs— Self-hostable single Go binary
Related on TokRepo
Discussion
Related Assets
NAPI-RS — Build Node.js Native Addons in Rust
Write high-performance Node.js native modules in Rust with automatic TypeScript type generation and cross-platform prebuilt binaries.
Mamba — Fast Cross-Platform Package Manager
A drop-in conda replacement written in C++ that resolves environments in seconds instead of minutes.
Plasmo — The Browser Extension Framework
Build, test, and publish browser extensions for Chrome, Firefox, and Edge using React or Vue with hot-reload and automatic manifest generation.