# ntfy

Send push notifications to your phone or desktop using PUT/POST

Repository: https://github.com/binwiederhier/ntfy
Canonical: https://ross.abutalabs.com/products/ntfy
Homepage: https://ntfy.sh
Language: Go
License: Apache-2.0
License Family: permissive
Topics: rest-api, pubsub, notifications, curl, push-notifications, ntfy, ntfysh
Last push: 2026-08-25T21:43:31+00:00
Link (homepage): https://ntfy.sh
Link (site_page): https://ntfy.sh/docs
Link (site_page): https://ntfy.sh/docs/publish
Link (site_page): https://docs.ntfy.sh/integrations
Link (site_page): https://docs.ntfy.sh/install

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 96, longevity 100
- inputs: {"age_days": 1775, "days_push": 8, "days_rel": 29, "gap_med": 17, "n_releases_24m": 20}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 33775, forks 1566 (observed 2026-08-28T04:11:58.440915+00:00)

## What it is
ntfy is a simple HTTP-based pub-sub notification service that lets you send push notifications to your phone or desktop via PUT/POST requests from any script or computer. It ships as a self-hostable Go server, a CLI, and open-source Android/iOS apps, with a free hosted instance at ntfy.sh.

## Use cases
- notify me when a long-running script or backup finishes
- send push alerts to my phone from curl or a cron job
- self-host a push notification server without sign-ups or fees
- alert on unauthorized logins or home automation sensor events
- send files and images to my phone from a server
- integrate notifications into Home Assistant, Uptime Kuma, or changedetection.io

## When to choose
- you want dead-simple push notifications via plain HTTP PUT/POST with no client SDK
- you need a self-hosted, free, open-source alternative to proprietary push services
- you want to alert from shell scripts, cron jobs, or monitoring tools like Uptime Kuma or Healthchecks.io
- you need notifications on Android/iOS with priorities, action buttons, tags, and attachments

## When to avoid
- you need guaranteed message delivery, queuing semantics, or durable consumer offsets rather than best-effort notifications
- you require end-to-end encryption of message content on the public ntfy.sh service
- you need rich two-way chat or a full messaging platform instead of one-way alerts

## Facets
- artifact type: service
- maturity: stable
- function: message-queue, http-server, cli, webhook, self-hosted
- domain: developer-tools, self-hosted, monitoring
- platform: windows, self-hosted, go, cross-platform
- tags: push-notifications, pub-sub, rest-api, notifications, curl-friendly, unifiedpush, messaging, automation, linux, macos, android, ios, docker

## Member repositories
- binwiederhier/ntfy (main) score 98
- binwiederhier/ntfy-android (frontend) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:58.440915+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:28:08.846686+00:00, confidence not recorded.
  - readme: https://github.com/binwiederhier/ntfy (fetched 2026-08-28T04:11:58.440915+00:00, sha e5e693a661e8)
  - homepage: https://ntfy.sh (fetched 2026-08-29T07:48:36.762489+00:00, sha 656d77d1fa37)
  - site_page: https://ntfy.sh/docs (fetched 2026-08-29T07:48:36.771801+00:00, sha 0d26ec1170b9)
  - site_page: https://ntfy.sh/docs/publish (fetched 2026-08-29T07:48:36.773854+00:00, sha 4e88b9a55be1)
  - site_page: https://docs.ntfy.sh/integrations (fetched 2026-08-29T07:48:36.778682+00:00, sha b8346dfe3f27)
  - site_page: https://docs.ntfy.sh/install (fetched 2026-08-29T07:48:36.781179+00:00, sha 872ecc345ff5)
  - site_page: https://docs.ntfy.sh/releases (fetched 2026-08-29T07:48:36.783776+00:00, sha 33f658223578)
- Data as of 2026-08-30T08:39:29.467469+00:00.