Self hosted Mobile Push Notifications using NTFY

I am slowly moving to LineageOS on my personal phone. The most important features I use on that phone are Email, Messaging, Mapping, and Alerts. I have found decent alternatives for Email, Messaging, and Mapping. Alerts or Notifications are something I depend on a lot; currently, they are Google or Apple features. I could settle down for pulls (I get a few alerts by way of RSS feeds), but push would be great. Especially for alerts from my home or servers. Hence was looking for it. NTFY suited my needs from all angles. Therefore I took some time to deploy it.


When I was looking for a solution, five primary factors were

ntfy did satisfy all those conditions.

ntfy (pronounce: notify) is a simple HTTP-based pub-sub notification service. It allows you to send notifications to your phone or desktop via scripts from any computer, entirely without signup, cost or setup. It's also open source if you want to run your own. 

ntfy website

When you are running a service like this on Android, power consumption can become as an issue. But I have been running it for a week now with Instant Delivery (foreground service) switched on. Battery consumption has been negligible. Delivery has been on time and stable.

Currently, I am running a self-hosted version using Docker. I have a few channels subscribed on a browser, a few Android phones, and desktops (CLI). It's been stable and working as expected.

Ntfy notification with image and action button.
Inside the app


My initial idea was to run the docker instance on cloud run, but billing is complicated for WebSockets on it. The next choice was AWS lightsail or one of my DO machines. But finally, I settled for Fly; it looked effortless and cheap to run such a machine on Fly. And it has been. 

Another option was to deploy it on my internal machine. But I didn't want to open a port to it from outside. The only option was to connect to it using a VPN, limiting its usage. It's a duct-tape system connecting many things. So it makes sense to be available on the public internet.  

I created a docker file and a new server.yml file for my server configuration. Added paths to my cache and auth SQLite databases. The path /data is mapped to a volume. So data gets saved even if the Docker is restarted.

FROM binwiederhier/ntfy
COPY server.yml /etc/ntfy/server.yml
ENTRYPOINT ["ntfy", "serve"]

server.yml looks like this

base-url: "https://<your_app>"
listen-http: ":80"
cache-file: "/data/cache.db"
attachment-cache-dir: "/data/attachments/"
auth-file: "/data/user.db"
auth-default-access: "deny-all"

Once deployed. I logged into the system, created users, and added access

ntfy web app
ntfy web app


ntfy on the top looks like a very simple service. But it's a simple and compelling pub/sub service with an excellent predefined message format and clients. I use their JSON message format with POST and Authorization header. That way, if I want to save a topic in the future, I can directly pipe it to a CouchDB. The message and Android provide a lot of wiring features.

  • Supports click action - where you can open the URL by clicking the message. Useful if you are sharing links between machines.
  • You can add actions like View a URL or  Open an App. These actions are visible as a button that you can click to continue with the action. For example, email client app using mailto:// or open map using geo:// etc.
  • You can also tie it to HTTP request to send further requests. Imagine one-time use capability URLs sent as part of message. I generally use HTTP Shortcut App for that and shortcuts:// as a link works. 
  • You can also broadcast the message so other apps can capture and consume it. Works well with tasker or macrodroid apps. This can be used to automate things.
  • Can carry attachments (directly attached or as URL) as part of the message
  • It supports UnifiedPush

What next?

I have not configured email delivery yet. I am working on that. I will enable it. This way the most important messages from my home can be delivered both on ntfy app and on my regular email client.

Note: There is a hosted service at, try it first before jumping into self-hosting.

You can read this blog using RSS Feed. But if you are the person who loves getting emails, then you can join my readers by signing up.

Join 2,242 other subscribers

1 Response

  1. August 27, 2022

    […] Self-hosted ntfy push notification system built on top of web technologies. It works like magic. So on my desktop and on my LineageOS, I can now get push notifications without the big two involved. Also, ntfy works well with the UnifiedPush notification system.  […]