1
0
Fork 0
mirror of https://github.com/binwiederhier/ntfy.git synced 2025-09-21 11:02:29 +02:00
Send push notifications to your phone or desktop using PUT/POST https://ntfy.sh
Find a file
Philipp C. Heckel c9a0a40805
Add warning for ntfy 1.17.0 on F-Droid
Added warning about broken ntfy version on F-Droid and provided alternatives for users.
2025-09-20 10:54:06 -04:00
.github Pipelines 2025-05-21 18:55:21 -04:00
assets Sponsors 2025-06-07 06:45:43 -04:00
client fixed typo 2025-08-21 00:05:05 +02:00
cmd Checks 2025-08-24 13:52:04 -04:00
docs Docs 2025-08-24 21:18:28 -04:00
examples Add JS websocket example 2023-11-15 09:28:35 -07:00
log Security updates 2025-05-21 18:49:19 -04:00
payments Add build tags for Firebase 2025-08-07 17:24:57 +02:00
scripts Update docs 2025-05-25 12:57:02 -04:00
server Docs 2025-08-24 21:18:28 -04:00
test Simplify(?) templating cases 2024-03-20 21:33:54 -04:00
tools Profiling support 2023-03-28 14:41:16 -04:00
user Fix tests 2025-08-09 10:04:57 -04:00
util Works 2025-07-21 17:44:00 +02:00
web Fix lint 2025-08-24 13:58:57 -04:00
.dockerignore Add a way to use Docker for building everything 2023-05-26 22:22:21 +02:00
.git-blame-ignore-revs Add eslint commits to .git-blame-ignore-revs 2023-05-24 12:58:49 +02:00
.gitignore teach ntfy webpush to write the keys to a file 2024-06-25 22:58:36 -07:00
.gitpod.yml
.goreleaser.yml Fix build 2025-07-10 21:06:39 +02:00
CODE_OF_CONDUCT.md
docker-compose.yml Update App Store badges and remove Docker compose versions 2025-06-20 00:45:42 +02:00
Dockerfile Revert Docker user fix 2024-03-07 16:59:42 -05:00
Dockerfile-arm Revert Docker user fix 2024-03-07 16:59:42 -05:00
Dockerfile-build Merge pull request #1307 from jlssmt/patch-1 2025-05-21 19:24:43 -04:00
go.mod Bump release notes and such 2025-08-05 10:09:58 +02:00
go.sum Bump release notes and such 2025-08-05 10:09:58 +02:00
LICENSE
LICENSE.GPLv2
main.go Undo main.go 2025-08-08 15:02:09 -04:00
Makefile Works 2025-07-21 17:44:00 +02:00
mkdocs.yml Refine 2025-07-21 10:28:26 +02:00
README.md Add warning for ntfy 1.17.0 on F-Droid 2025-09-20 10:54:06 -04:00
requirements.txt Remove dependence on mkdocs-simple-hooks 2024-02-05 13:29:55 +01:00
SECURITY.md Create SECURITY.md 2023-03-02 21:39:04 -05:00

⚠️ F-Droid: Do not upgrade to ntfy 1.17.0

9/20/2025

📢 BROKEN ntfy version on F-Droid: I am so sorry, but it looks like ntfy 1.17.0 got released on F-Droid accidentally. Please DO NOT UPDATE, as the app will crash on startup and will not work.

You can join the Google Play beta to upgrade to 1.17.8 (in testing!!) or manually install the .apk file from https://github.com/binwiederhier/ntfy-android/releases/tag/v1.17.8:

My sincere apologies. I forgot that F-Droid automatically picks up tags. It's been a while. I suggest that you use the Backup feature in ntfy (Settings -> Back up to file) to save your current database to a json file, just in case.

F-Droid release cycles take a while, so this will take a few days to get fixed. I am very sorry, guys.


ntfy

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

Release Go Reference Tests Go Report Card codecov Discord Matrix Matrix space 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 ntfy.sh. 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 ntfy.sh 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 $5/month. You can also donate via GitHub Sponsors, and Liberapay. I would be very humbled by your sponsorship. ❤️

Documentation

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 ntfy.sh/announcements 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).

Sponsors

If you'd like to support the ntfy maintainers, please consider donating to GitHub Sponsors or and Liberapay. We would be humbled if you helped carry the server and developer account costs. Even small donations are very much appreciated.

Thank you to our commercial sponsors, who help keep the service running and the development going:

And a big fat Thank You to the individuals who have sponsored ntfy in the past, or are still sponsoring ntfy:

Contributing

I welcome any 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

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.

License

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: