 # ntfy.sh | Send push notifications to your phone or desktop via PUT/POST [](https://github.com/binwiederhier/ntfy/releases/latest) [](https://pkg.go.dev/heckel.io/ntfy) [](https://github.com/binwiederhier/ntfy/actions) [](https://goreportcard.com/report/github.com/binwiederhier/ntfy) [](https://codecov.io/gh/binwiederhier/ntfy) [](https://discord.gg/cT7ECsZj9w) [](https://matrix.to/#/#ntfy:matrix.org) [](https://matrix.to/#/#ntfy-space:matrix.org) [](https://discuss.ntfy.sh/) [](https://ntfy.statuspage.io/) [](https://gitpod.io/#https://github.com/binwiederhier/ntfy) **ntfy** (pronounced "*notify*") is a simple HTTP-based [pub-sub](https://en.wikipedia.org/wiki/Publish%E2%80%93subscribe_pattern) 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](https://ntfy.sh)**. There is also an [open source Android app](https://github.com/binwiederhier/ntfy-android) available on [Google Play](https://play.google.com/store/apps/details?id=io.heckel.ntfy) or [F-Droid](https://f-droid.org/en/packages/io.heckel.ntfy/), as well as an [open source iOS app](https://github.com/binwiederhier/ntfy-ios) available on the [App Store](https://apps.apple.com/us/app/ntfy/id1625396347). <p> <img src=".github/images/screenshot-curl.png" height="180"> <img src=".github/images/screenshot-web-detail.png" height="180"> <img src=".github/images/screenshot-phone-main.jpg" height="180"> <img src=".github/images/screenshot-phone-detail.jpg" height="180"> <img src=".github/images/screenshot-phone-notification.jpg" height="180"> </p> ## [ntfy Pro](https://ntfy.sh/app) πΈ π I now offer paid plans for [ntfy.sh](https://ntfy.sh/) if you don't want to self-host, or you want to support the development of ntfy (β [Purchase via web app](https://ntfy.sh/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](https://github.com/sponsors/binwiederhier), and [Liberapay](https://liberapay.com/ntfy). I would be very humbled by your sponsorship. β€οΈ ## **[Documentation](https://ntfy.sh/docs/)** [Getting started](https://ntfy.sh/docs/) | [Android/iOS](https://ntfy.sh/docs/subscribe/phone/) | [API](https://ntfy.sh/docs/publish/) | [Install / Self-hosting](https://ntfy.sh/docs/install/) | [Building](https://ntfy.sh/docs/develop/) ## 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: * [Discord server](https://discord.gg/cT7ECsZj9w) - direct chat with the community * [Matrix room #ntfy](https://matrix.to/#/#ntfy:matrix.org) (+ [Matrix space](https://matrix.to/#/#ntfy-space:matrix.org)) - same chat, bridged from Discord * [Lemmy discussion board](https://discuss.ntfy.sh/) - asynchronous forum (_new as of June 2023_) * [GitHub issues](https://github.com/binwiederhier/ntfy/issues) - questions, features, bugs * [Email](https://heckel.io/about) - reach me directly (_I usually prefer the other methods_) ## Announcements / beta testers For announcements of new releases and cutting-edge beta versions, please subscribe to the [ntfy.sh/announcements](https://ntfy.sh/announcements) topic. If you'd like to test the iOS app, join [TestFlight](https://testflight.apple.com/join/P1fFnAm9). For Android betas, join Discord/Matrix (I'll eventually make a testing channel in Google Play). ## Contributing 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](https://ntfy.sh/docs/develop/) for the server and the Android app. Or, if you'd like to help translate π©πͺ πΊπΈ π§π¬, you can start immediately in [Hosted Weblate](https://hosted.weblate.org/projects/ntfy/). <a href="https://hosted.weblate.org/engage/ntfy/"> <img src="https://hosted.weblate.org/widgets/ntfy/-/multi-blue.svg" alt="Translation status" /> </a> ## Sponsors I have just very recently started accepting donations via [GitHub Sponsors](https://github.com/sponsors/binwiederhier), and [Liberapay](https://liberapay.com/ntfy). 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: <a href="https://github.com/neutralinsomniac"><img src="https://github.com/neutralinsomniac.png" width="40px" /></a> <a href="https://github.com/aspyct"><img src="https://github.com/aspyct.png" width="40px" /></a> <a href="https://github.com/nickexyz"><img src="https://github.com/nickexyz.png" width="40px" /></a> <a href="https://github.com/qcasey"><img src="https://github.com/qcasey.png" width="40px" /></a> <a href="https://github.com/mckay115"><img src="https://github.com/mckay115.png" width="40px" /></a> <a href="https://github.com/Salamafet"><img src="https://github.com/Salamafet.png" width="40px" /></a> <a href="https://github.com/codinghipster"><img src="https://github.com/codinghipster.png" width="40px" /></a> <a href="https://github.com/HinFort"><img src="https://github.com/HinFort.png" width="40px" /></a> <a href="https://github.com/Lexevolution"><img src="https://github.com/Lexevolution.png" width="40px" /></a> <a href="https://github.com/johnnyip"><img src="https://github.com/johnnyip.png" width="40px" /></a> <a href="https://github.com/JonDerThan"><img src="https://github.com/JonDerThan.png" width="40px" /></a> <a href="https://github.com/12nick12"><img src="https://github.com/12nick12.png" width="40px" /></a> <a href="https://github.com/eanplatter"><img src="https://github.com/eanplatter.png" width="40px" /></a> <a href="https://github.com/fnoelscher"><img src="https://github.com/fnoelscher.png" width="40px" /></a> <a href="https://github.com/bnorick"><img src="https://github.com/bnorick.png" width="40px" /></a> <a href="https://github.com/snh"><img src="https://github.com/snh.png" width="40px" /></a> <a href="https://github.com/hen-x"><img src="https://github.com/hen-x.png" width="40px" /></a> <a href="https://github.com/JamieGoodson"><img src="https://github.com/JamieGoodson.png" width="40px" /></a> <a href="https://github.com/cremesk"><img src="https://github.com/cremesk.png" width="40px" /></a> <a href="https://github.com/dangowans"><img src="https://github.com/dangowans.png" width="40px" /></a> <a href="https://github.com/mnault"><img src="https://github.com/mnault.png" width="40px" /></a> <a href="https://github.com/nwithan8"><img src="https://github.com/nwithan8.png" width="40px" /></a> <a href="https://github.com/peterleiser"><img src="https://github.com/peterleiser.png" width="40px" /></a> <a href="https://github.com/portothree"><img src="https://github.com/portothree.png" width="40px" /></a> <a href="https://github.com/finngreig"><img src="https://github.com/finngreig.png" width="40px" /></a> <a href="https://github.com/skrollme"><img src="https://github.com/skrollme.png" width="40px" /></a> <a href="https://github.com/gergepalfi"><img src="https://github.com/gergepalfi.png" width="40px" /></a> <a href="https://github.com/tonyakwei"><img src="https://github.com/tonyakwei.png" width="40px" /></a> <a href="https://github.com/crosbyh"><img src="https://github.com/crosbyh.png" width="40px" /></a> <a href="https://github.com/mdlnr"><img src="https://github.com/mdlnr.png" width="40px" /></a> <a href="https://github.com/p-samuel"><img src="https://github.com/p-samuel.png" width="40px" /></a> <a href="https://github.com/zugaldia"><img src="https://github.com/zugaldia.png" width="40px" /></a> <a href="https://github.com/NathanSweet"><img src="https://github.com/NathanSweet.png" width="40px" /></a> <a href="https://github.com/msdeibel"><img src="https://github.com/msdeibel.png" width="40px" /></a> <a href="https://github.com/ksurl"><img src="https://github.com/ksurl.png" width="40px" /></a> <a href="https://github.com/CodingTimeDEV"><img src="https://github.com/CodingTimeDEV.png" width="40px" /></a> <a href="https://github.com/Terrormixer3000"><img src="https://github.com/Terrormixer3000.png" width="40px" /></a> <a href="https://github.com/voroskoi"><img src="https://github.com/voroskoi.png" width="40px" /></a> <a href="https://github.com/Nickwasused"><img src="https://github.com/Nickwasused.png" width="40px" /></a> <a href="https://github.com/bahur142"><img src="https://github.com/bahur142.png" width="40px" /></a> <a href="https://github.com/vinhdizzo"><img src="https://github.com/vinhdizzo.png" width="40px" /></a> <a href="https://github.com/Ge0rg3"><img src="https://github.com/Ge0rg3.png" width="40px" /></a> <a href="https://github.com/biopsin"><img src="https://github.com/biopsin.png" width="40px" /></a> <a href="https://github.com/thebino"><img src="https://github.com/thebino.png" width="40px" /></a> <a href="https://github.com/sky4055"><img src="https://github.com/sky4055.png" width="40px" /></a> <a href="https://github.com/julianlam"><img src="https://github.com/julianlam.png" width="40px" /></a> <a href="https://github.com/andreapx"><img src="https://github.com/andreapx.png" width="40px" /></a> <a href="https://github.com/billycao"><img src="https://github.com/billycao.png" width="40px" /></a> <a href="https://github.com/zoic21"><img src="https://github.com/zoic21.png" width="40px" /></a> <a href="https://github.com/IanKulin"><img src="https://github.com/IanKulin.png" width="40px" /></a> <a href="https://github.com/Joachim256"><img src="https://github.com/Joachim256.png" width="40px" /></a> <a href="https://github.com/overtone1000"><img src="https://github.com/overtone1000.png" width="40px" /></a> <a href="https://github.com/oakd"><img src="https://github.com/oakd.png" width="40px" /></a> <a href="https://github.com/KucharczykL"><img src="https://github.com/KucharczykL.png" width="40px" /></a> <a href="https://github.com/hansbickhofe"><img src="https://github.com/hansbickhofe.png" width="40px" /></a> <a href="https://github.com/caseodilla"><img src="https://github.com/caseodilla.png" width="40px" /></a> <a href="https://github.com/0xAF"><img src="https://github.com/0xAF.png" width="40px" /></a> <a href="https://github.com/soonoo"><img src="https://github.com/soonoo.png" width="40px" /></a> <a href="https://github.com/nichu42"><img src="https://github.com/nichu42.png" width="40px" /></a> <a href="https://github.com/samliebow"><img src="https://github.com/samliebow.png" width="40px" /></a> <a href="https://github.com/johman10"><img src="https://github.com/johman10.png" width="40px" /></a> <a href="https://github.com/R-Gld"><img src="https://github.com/R-Gld.png" width="40px" /></a> <a href="https://github.com/FingerlessGlov3s"><img src="https://github.com/FingerlessGlov3s.png" width="40px" /></a> <a href="https://github.com/Twisterado"><img src="https://github.com/Twisterado.png" width="40px" /></a> <a href="https://github.com/ScrumpyJack"><img src="https://github.com/ScrumpyJack.png" width="40px" /></a> <a href="https://github.com/andrejarrell"><img src="https://github.com/andrejarrell.png" width="40px" /></a> <a href="https://github.com/oaustegard"><img src="https://github.com/oaustegard.png" width="40px" /></a> <a href="https://github.com/CreativeWarlock"><img src="https://github.com/CreativeWarlock.png" width="40px" /></a> <a href="https://github.com/darkdragon-001"><img src="https://github.com/darkdragon-001.png" width="40px" /></a> <a href="https://github.com/jonathan-kosgei"><img src="https://github.com/jonathan-kosgei.png" width="40px" /></a> <a href="https://github.com/KevinWang15"><img src="https://github.com/KevinWang15.png" width="40px" /></a> I'd also like to thank JetBrains for providing their awesome [IntelliJ IDEA](https://www.jetbrains.com/idea/) to me for free, and [DigitalOcean](https://m.do.co/c/442b929528db) (*referral link*) for supporting the project: <a href="https://m.do.co/c/442b929528db"><img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px"></a> ## 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](CODE_OF_CONDUCT.md)._ ## License Made with β€οΈ by [Philipp C. Heckel](https://heckel.io). The project is dual licensed under the [Apache License 2.0](LICENSE) and the [GPLv2 License](LICENSE.GPLv2). Third party libraries and resources: * [github.com/urfave/cli](https://github.com/urfave/cli) (MIT) is used to drive the CLI * [Mixkit sounds](https://mixkit.co/free-sound-effects/notification/) (Mixkit Free License) are used as notification sounds * [Sounds from notificationsounds.com](https://notificationsounds.com) (Creative Commons Attribution) are used as notification sounds * [Roboto Font](https://fonts.google.com/specimen/Roboto) (Apache 2.0) is used as a font in everything web * [React](https://reactjs.org/) (MIT) is used for the web app * [Material UI components](https://mui.com/) (MIT) are used in the web app * [MUI dashboard template](https://github.com/mui/material-ui/tree/master/docs/data/material/getting-started/templates/dashboard) (MIT) was used as a basis for the web app * [Dexie.js](https://github.com/dexie/Dexie.js) (Apache 2.0) is used for web app persistence in IndexedDB * [GoReleaser](https://goreleaser.com/) (MIT) is used to create releases * [go-smtp](https://github.com/emersion/go-smtp) (MIT) is used to receive e-mails * [stretchr/testify](https://github.com/stretchr/testify) (MIT) is used for unit and integration tests * [github.com/mattn/go-sqlite3](https://github.com/mattn/go-sqlite3) (MIT) is used to provide the persistent message cache * [Firebase Admin SDK](https://github.com/firebase/firebase-admin-go) (Apache 2.0) is used to send FCM messages * [github/gemoji](https://github.com/github/gemoji) (MIT) is used for emoji support (specifically the [emoji.json](https://raw.githubusercontent.com/github/gemoji/master/db/emoji.json) file) * [Lightbox with vanilla JS](https://yossiabramov.com/blog/vanilla-js-lightbox) as a lightbox on the landing page * [HTTP middleware for gzip compression](https://gist.github.com/CJEnright/bc2d8b8dc0c1389a9feeddb110f822d7) (MIT) is used for serving static files * [Regex for auto-linking](https://github.com/bryanwoods/autolink-js) (MIT) is used to highlight links (the library is not used) * [Statically linking go-sqlite3](https://www.arp242.net/static-go.html) * [Linked tabs in mkdocs](https://facelessuser.github.io/pymdown-extensions/extensions/tabbed/#linked-tabs) * [webpush-go](https://github.com/SherClockHolmes/webpush-go) (MIT) is used to send web push notifications