ScriptsApr 10, 2026·3 min read

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.

TL;DR
ntfy sends push notifications to any device with a simple HTTP request. No signup or API keys required.
§01

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.

§02

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.

§03

How to use

  1. Install the ntfy app on your phone (Android/iOS) or use the web client.
  2. Subscribe to a topic of your choice.
  3. 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
§04

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
§05

Related on TokRepo

§06

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

Is ntfy free?+

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.

Do I need an API key?+

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.

Can I self-host ntfy?+

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.

Does ntfy support attachments?+

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.

What platforms does ntfy support?+

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)

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets