Send push notifications to your phone or desktop using PUT/POST
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
binwiederhier 733ef4664b Deps 3 days ago
.github Move checkout up since the cache needs lockfiles 3 weeks ago
assets Styling 2 years ago
client Fix previous fix 1 week ago
cmd Fix previous fix 1 week ago
docs Integrations 3 days ago
examples Troubleshooting docs page 3 months ago
log Self-review 3 weeks ago
scripts Make emojis in docs larger 2 months ago
server Do not forward UP messages to upstream 1 week ago
test Do not print ugly WS error; tests 1 year ago
tools Profiling support 2 months ago
user The last one 3 weeks ago
util Fix false positive in ContainsAll function 4 weeks ago
web Deps 3 days ago
.dockerignore Add a way to use Docker for building everything 2 weeks ago
.git-blame-ignore-revs Add eslint commits to .git-blame-ignore-revs 2 weeks ago
.gitignore .gitignore 1 week ago
.gitpod.yml Add Gitpod configuration for quick setup of development environments 6 months ago
.goreleaser.yml Logo in rpm file 3 weeks ago Code of Conduct 6 months ago
Dockerfile refined dockerfile 3 months ago
Dockerfile-build Add a way to use Docker for building everything 2 weeks ago
LICENSE Update LICENSE 2 years ago
LICENSE.GPLv2 Update LICENSE.GPLv2 2 years ago
Makefile Add a way to use Docker for building everything 2 weeks ago You rock Jonathan. Thank you for your sponsorship @jonathan-kosgei 3 weeks ago Create 3 months ago
docker-compose.yml add tzdata to image and use env for docker timezone 1 year ago
go.mod Update deps 3 days ago
go.sum Update deps 3 days ago
main.go Remove urfave/cli workaround 1 year ago
mkdocs.yml Replace favicon 1 month ago
requirements.txt Built mkdocs plugin, set font to desired options 3 months ago

ntfy | Send push notifications to your phone or desktop via PUT/POST

Release Go Reference Tests Go Report Card codecov Discord Matrix Matrix space Reddit Healthcheck Gitpod

ntfy (pronounced "notify") is a simple HTTP-based pub-sub notification service. With ntfy, you can send notifications to your phone or desktop via scripts from any computer, without having to sign up or pay any fees. If you'd like to run your own instance of the service, you can easily do so since ntfy is open source.

You can access the free version of ntfy at There is also an open source Android app available on Google Play or F-Droid, as well as an open source iOS app available on the App Store.

ntfy Pro 💸 🎉

I now offer paid plans for if you don't want to self-host, or you want to support the development of ntfy (→ Purchase via web app). You can buy a plan for as low as $3.33/month (if you use promo code MYTOPIC, limited time only). You can also donate via GitHub Sponsors, and Liberapay. I would be very humbled by your sponsorship. ❤️


Getting started | Android/iOS | API | Install / Self-hosting | Building

Chat / forum

There are a few ways to get in touch with me and/or the rest of the community. Feel free to use any of these methods. Whatever works best for you:

Announcements / beta testers

For announcements of new releases and cutting-edge beta versions, please subscribe to the topic. If you'd like to test the iOS app, join TestFlight. For Android betas, join Discord/Matrix (I'll eventually make a testing channel in Google Play).


I welcome any and all contributions. Just create a PR or an issue. For larger features/ideas, please reach out on Discord/Matrix first to see if I'd accept them. To contribute code, check out the build instructions for the server and the Android app. Or, if you'd like to help translate 🇩🇪 🇺🇸 🇧🇬, you can start immediately in Hosted Weblate.

Translation status


I have just very recently started accepting donations via GitHub Sponsors, and Liberapay. I would be humbled if you helped me carry the server and developer account costs. Even small donations are very much appreciated. A big fat Thank You to the folks already sponsoring ntfy:

I'd also like to thank JetBrains for providing their awesome IntelliJ IDEA to me for free, and DigitalOcean (referral link) for supporting the project:

Code of Conduct

We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.

We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.

Please be sure to read the complete Code of Conduct.


Made with ❤️ by Philipp C. Heckel.
The project is dual licensed under the Apache License 2.0 and the GPLv2 License.

Third party libraries and resources: