# Ntfy

Ntfy is a simple HTTP-based publish-subscribe notification service that lets you send push notifications to your phone or desktop from any computer using scripts or curl. It is open source and self-hosted, installable on Docker Hub, Proxmox, Umbrel, Unraid, Kubernetes (Helm), ZimaOS and TrueNAS.

Canonical page: https://ourlocalhost.com/app/458/ntfy

## Description

Ntfy is a simple HTTP-based publish-subscribe notification service that lets you send push notifications to your phone or desktop from any computer using scripts or curl. It is open source and free to self-host, with no signup, account, or cost required. A lightweight, self-contained option for home lab users who want to trigger notifications from their own infrastructure.

## Platform availability

Available on 6 of 9 platforms: Unraid, TrueNAS, Umbrel, ZimaOS, Proxmox, Helm.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 0 (GitHub repository no longer exists)
- Easy to install: 85 (6 install platforms, install notes, Docker image)
- Light to run: 95 (307 MB minimum RAM, runs on ARM)

## Links

- GitHub: https://github.com/binwiederhier/ntfy
- Documentation: https://ntfy.sh/docs
- Docker Hub: https://hub.docker.com/r/binwiederhier/ntfy
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=ntfy
- Umbrel: https://apps.umbrel.com/app/ntfy
- Unraid: https://ca.unraid.net/apps/ntfy-1e89xse0vxsnka?q=Ntfy
- Official website: https://ntfy.sh
- Kubernetes (Helm): https://artifacthub.io/packages/helm/ntfy/ntfy
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/ntfysh
- TrueNAS: https://apps.truenas.com/catalog/ntfy/

## Common questions

### What port does ntfy serve listen on by default, and how can I change it?

By default it waits for connections on port 80, which may require admin rights. Use ntfy serve --listen-http :8080 to listen on another port, then point browsers or devices to that port.

### How can I verify that a self-hosted ntfy server receives test messages?

Install Apprise with pip3 install apprise, then send apprise -b 'Hi there' ntfys://mytopic to a test topic. This confirms the path to your ntfy server works.

### How should I choose topic names when using ntfy without sign-up?

Without sign-up, the topic is essentially a password, so choose a name that is not easily guessable. ntfy Pro lets you reserve topic names instead.

### What base URL issue can affect a self-hosted ntfy server with the iOS app?

A missing upstream-base-url or a base-url mismatch can prevent the self-hosted server from working with the iOS app. The docs point to the iOS instant notifications section for details.

## Alternatives

- Gotify: Gotify is a self-hosted server for sending and receiving push notifications.
- Healthchecks.io: Healthchecks.io is a service for monitoring cron jobs and similar periodic processes:
- Pushbullet: Send links, files, photos, lists, and notes instantly between devices, mirror phone notifications to desktop, and access clipboard syncing…
- Pushover: Pushover is a simple push notification service that integrates easily into web apps, network monitoring systems, shell scripts, and anythin…

---
Source: Our Local Host (https://ourlocalhost.com/app/458/ntfy), the self-hosted and open-source app directory.