# Install ntfy with Homebrew, apk, apt, Nix, scoop

Send push notifications to your phone or desktop via PUT/POST. Version 2.26.3 via Homebrew; verified 2026-07-26. Also installable with debian: sudo apt install ntfy.

## Install

```sh
sudo av install brew:ntfy
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ntfy
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add ntfy
```

  Evidence: Alpine Linux edge package indexes: ntfy from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install ntfy
```

  Evidence: Debian stable package indexes: ntfy from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#ntfy
```

  Evidence: nixpkgs package indexes: pkgs/by-name/nt/ntfy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install main/ntfy
```

  Evidence: Scoop official bucket manifest trees: bucket/ntfy.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:ntfy
- **Package manager:** Homebrew
- **Version:** 2.26.3
- **Source summary:** Send push notifications to your phone or desktop via PUT/POST
- **Homepage:** <https://ntfy.sh/>
- **Repository:** <https://github.com/binwiederhier/ntfy>
- **Last updated:** 2026-07-26T19:43:17+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- ntfy (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.26.3
## Project history and usage

ntfy is a Go-based HTTP pub/sub notification service whose package identity is unusually clear: the CLI, public ntfy.sh service, self-hosted server, Android app, iOS app, and docs all center on the same simple PUT/POST-to-a-topic workflow.

### Project history

The GitHub repository was created on 2021-10-23. The README describes ntfy as a service for sending notifications to phone or desktop from scripts without signup or fees, while also supporting self-hosting.

### Adoption history

Adoption grew through a practical package-nerd path rather than a formal platform: a public hosted service, Homebrew/Linux packages, mobile apps on Google Play, F-Droid, and the Apple App Store, and integrations documented around cron, Ansible, GitHub Actions, changedetection.io, Watchtower/shoutrrr, and Apprise-style URLs.

Its GitHub repository showed substantial public use by 2026-07-01, with the API reporting 31,047 stars and 1,326 forks. Treat that as a point-in-time signal, not a stable project fact.

### How it is used

The common use is deliberately small: publish text with curl or `ntfy publish`, subscribe a phone or browser to the topic, and wire the endpoint into scripts. The docs show people using it for backup success/failure messages, low disk alerts, SSH login alerts, distributed job result collection, configuration-management notifications, and CI status pings.

Self-hosters care about the server/client split and config locations; casual users often treat ntfy.sh as a disposable webhook endpoint for personal operational alerts.

### Why package nerds care

ntfy matters because it turns push notifications into a Unix-shaped primitive: a URL, a topic, and stdin. It competes less with chat systems than with little piles of brittle webhook glue.

### Timeline

- 2021-10-23: GitHub repository created.
- 2022: iOS app availability followed the earlier Android/F-Droid distribution path, making the project useful across the common phone platforms.
- 2026-07-01: GitHub API point-in-time snapshot reported 31,047 stars and 1,326 forks.

### Related projects

- ntfy-android
- ntfy-ios
- Apprise
- shoutrrr
- changedetection.io

### Sources

- <https://api.github.com/repos/binwiederhier/ntfy>
- <https://formulae.brew.sh/formula/ntfy>
- <https://github.com/binwiederhier/ntfy>
- <https://raw.githubusercontent.com/binwiederhier/ntfy/main/README.md>
- <https://raw.githubusercontent.com/binwiederhier/ntfy/main/docs/examples.md>
- <https://raw.githubusercontent.com/binwiederhier/ntfy/main/docs/index.md>


## Security Notes

No matching local secret-handling manifest was found for ntfy. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: /etc/ntfy/server.yml, /etc/ntfy/client.yml, ~/.config/ntfy/client.yml
- macOS: ~/Library/Application Support/ntfy/client.yml
- Windows: %ProgramData%\ntfy\server.yml, %AppData%\ntfy\client.yml

## Credential files

- Linux: /var/lib/ntfy/user.db, /etc/ntfy/client.yml, ~/.config/ntfy/client.yml
- macOS: ~/Library/Application Support/ntfy/client.yml
- Windows: %ProgramData%\ntfy\user.db, %AppData%\ntfy\client.yml
## Other Package-Manager Records

- Debian apt - ntfy - 2.11.0-2+b4: normalized package name match | Debian stable package indexes: ntfy from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Send push notifications to your phone or desktop | https://github.com/binwiederhier/ntfy
- Nix - ntfy: normalized package name match | nixpkgs package indexes: pkgs/by-name/nt/ntfy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - ntfy - 2.23.0-r1: normalized package name match | Alpine Linux edge package indexes: ntfy from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A simple HTTP-based pub-sub notification service | https://ntfy.sh/
- apk - ntfy-openrc - 2.23.0-r1: normalized package name match | Alpine Linux edge package indexes: ntfy-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A simple HTTP-based pub-sub notification service (OpenRC init scripts) | https://ntfy.sh/
- Scoop - main/ntfy: normalized package name match | Scoop official bucket manifest trees: bucket/ntfy.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/ntfy.yml](https://github.com/mxcl/pkgdb/blob/main/combined/ntfy.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph