---
title: "ntfy"
description: "Push formatted AlertHub alerts to ntfy.sh or a self-hosted ntfy server via a topic URL."
order: 10
---

Receive warning and critical alerts on your phone or desktop with the ntfy app.

## Setup

1.  Install the [ntfy app](https://ntfy.sh/) (Android, iOS, or the web app).
2.  Subscribe to a **hard-to-guess topic** (letters, numbers, `_` and `-`; max 64 characters). The topic name is the secret.
3.  Cloud URL: `https://ntfy.sh/YOUR_TOPIC`. Self-hosted: `https://your-ntfy-host/YOUR_TOPIC` (keep a subpath if ntfy is not at the domain root). For a reserved topic, append `?auth=…` (see [ntfy authentication](https://docs.ntfy.sh/publish/#authentication)).
4.  In AlertHub, open the project **Connections** tab and click the **ntfy** card.
5.  Paste the topic URL and save. HTTPS is required; a self-hosted server must be reachable from the internet.

AlertHub POSTs the message body with `Title`, `Priority` (5 for critical, 4 for warning), and `Tags` headers. Info stays in the dashboard.