# ntfy

ntfy (pronounced "*notify*") is a pub-sub push notification service: publish a message to a topic with a plain HTTP PUT/POST (even just `curl`), and every device subscribed to that topic gets a push notification instantly. No vendor SDKs, no signup flows, no per-message fees.

It's the missing notification layer for everything else you run: cron jobs, backup scripts, \*arr apps, Uptime Kuma alerts, home automation, or anything that can make an HTTP request. Messages support titles, priorities, tags, attachments, action buttons, and scheduled delivery.

[Get a 7-day trial of ElfHosted ntfy! 🪄](<https://store.elfhosted.com/product/ntfy/>)

## How do I access ntfy?

ntfy is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-ntfy.elfhosted.com](<https://your-username-ntfy.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/ntfy/>) and these become your personal, clickable links.

## How do I use it?

Your ntfy instance ships locked down: access is **deny-all by default**, so nobody can publish to (or snoop on) your topics without an account. Manage users and their per-topic permissions from within the app under **Account**.

### Connect the mobile apps

Install the ntfy app for [Android](<https://play.google.com/store/apps/details?id=io.heckel.ntfy>) (also on [F-Droid](<https://f-droid.org/en/packages/io.heckel.ntfy/>)) or [iOS](<https://apps.apple.com/us/app/ntfy/id1625396347>). In the app settings, set the **default server** to your instance URL (not ntfy.sh), sign in with your ntfy user, and subscribe to a topic.

### Send your first notification

From any machine or app that can make an HTTP request:

```
curl -u user:password -d "Backup complete!" https://your-instance-url/mytopic
```

Anything subscribed to `mytopic` pings immediately. From there, wire it into your other apps: most tools with webhook or Apprise support can target ntfy directly, see the [publishing docs](<https://ntfy.sh/docs/publish/>) for the full feature set (priorities, emails, action buttons, attachments, and more).

## How do I get support for ntfy?

1. For general use of ntfy, refer to the [official site](<https://github.com/binwiederhier/ntfy>) or to one of the links in the resources section below.
2. For specific support re your ElfHosted configuration / account, see the [ElfHosted support options](</get-help/>)!

## Sponsor ntfy ❤️

You can contribute directly to the development of ntfy using the following:

- [GitHub Sponsors](<https://github.com/sponsors/binwiederhier>)
- [Liberapay](<https://liberapay.com/ntfy>)

## ntfy resources

- [ntfy (*official site*)](<https://github.com/binwiederhier/ntfy>)
- [ntfy Documentation](<https://ntfy.sh/docs/>)
- [ntfy Discord](<https://discord.gg/cT7ECsZj9w>)
- [ntfy Matrix](<https://matrix.to/#/#ntfy:matrix.org>)
