Complete Ntfy Guide: How to Set Up and Troubleshoot Push Notifications

Last update: 24/06/2026

  • Ntfy is a REST-based publish and subscribe system that allows you to send instant alerts to multiple devices without complex configurations.
  • It supports the implementation of your own servers using Docker, allowing full control over privacy and the management of users and permissions.
  • It supports a wide range of integrations, from PowerShell scripts and HTTP requests to the Unified Push standard on Android.
  • It requires specific network configurations and public URLs to ensure the receipt of push notifications on iOS devices.
Setting up and troubleshooting push notifications in NTFy

If you've ever felt a bit skeptical about entrusting all your sensitive information to giants like Google, Apple, or even Telegram, you'll know that finding your own notification alternative is almost a risky business. Sometimes, all it takes is for a service to go down or change its policies to leave us completely in the dark about what's happening on our servers or in our applications, and that's where a versatile tool like [tool name] comes in. ntfy (which, by the way, is pronounced "notify").

Basically, we are dealing with a system of publication-subscription Based on REST, it allows us to trigger alerts for specific topics without having to set up a massive infrastructure. It's an ideal option for those seeking simplicity but who don't want to sacrifice the power of automating processes, whether through simple scripts or more advanced integrations, always maintaining the total control of the data.

Related article:
How can I receive push notifications?

How to set up your own NTFS server

How to set up your own NTFS server

For those who prefer not to complicate their lives with manual binary installations, the best route is to use Docker and Docker ComposeIt's the cleanest way to maintain the service and greatly simplifies updates. You only need one file. docker-compose.yml Basic configuration where you define the user and group to avoid permission problems in Linux and expose port 80 to access the panel.

Exclusive content - Click Here  The Play Store will warn and penalize apps that drain battery.

For everything to run smoothly, it is essential to create two directories: one for the data cache (where images or attachments will be stored) and another for the configurationThe file resides in this last one. server.ymlwhich is the heart of the server. Here are some parameters you can't overlook:

  • base-urlThis is your server's public address. If you don't include it, iOS devices won't know where to look for notifications, and download links will fail.
  • auth-default-accessIf you want your server to be private and not just anyone can read your alerts, configure it as deny-all.
  • behind-proxyIf you use Cloudflare, Nginx, or Traefik, mark this option as true so that the server can properly manage the headers.
  • attachment-cache-dirDefine where temporary files will be stored and the maximum space they can occupy. Don't fill up your hard drive due to carelessness.
  • upstream-base-urlVery important for iOS; this indicates the server that will serve as a bridge for Apple and Google notifications.
Related article:
How do I set up push notifications on my iOS device?

User management and access control

Once the container is up, you can't leave the door wide open. To manage who enters and exits, the best way is to access the container's console using [the appropriate command/method]. docker exec and use the command ntfy user add for create individual accountsYou can assign the administrator role to those who need full control over all topics.

The magic of ntfy lies in its theme-based permissions system. If you want a specific user to only be able to read and write to themes that begin with "house-", simply run an access command using wild cardsOn the other hand, if you need Android applications that use the standard Unified Push For them to work, you will need to grant read and write permissions to the user. everyone for topics that begin with "up*".

Exclusive content - Click Here  How to organize notes in OneNote?

Ways to receive and send alerts

Ways to receive and send alerts in NTFy

The flexibility of this system is incredible. To receive messages, you simply... subscribe to a topic (which is basically a path in the URL) through the web interface, the mobile app or the iOS version. The process is as simple as choosing a unique name to prevent some curious person from subscribing to your alerts by pure coincidence.

To send the information, you have a huge range of options: curl For terminal purists, the binary ntfy-cli or even PowerShell scripts in Windows Server. In this latter case, it is common to encounter certificate errors; to resolve this, it is recommended to make a POST request including the Bearer authentication encoded in base64 to ensure the message reaches its destination without problems.

Web notifications keep coming in even with the browser turned off.
Related article:
Why web notifications keep arriving even when the browser is closed, and how to control them

Additionally, ntfy allows you to increase the notification level. You can add tags to display emojisYou can set the priority (from minimum to urgent) and even create action buttons. Imagine receiving an alert that your server's temperature is too high and having a button in the same notification to run a cooling script or remotely shut down a machine.

Exclusive content - Click Here  How to Use Vivacut

Troubleshooting common problems: The iOS and Android headache

One of the most frequent problems occurs on iPhone, where the user sees that everything works on the web but that Push notifications never arrive Unless you open the app and refresh manually. This is usually because iOS devices require the server to be accessible from the internet via HTTPS (ports 80/443) so that Apple's notification service can deliver the message.

If your server is on a local network without open ports, the app likely won't receive the necessary "push" to wake up and display the alert. On Android, while it's more flexible, it's vital to ensure the app has the necessary permissions, and if you're using F-Droid or Google PlayCheck that power saving isn't killing the ntfy background process, as sometimes Android notifications arrive late.

There are also interesting integrations such as sending alerts via emailwhere the email subject becomes the notification topic. It's even possible to convert attachments into temporary links simply by adding a bookmark like in the matter, which makes the flow of information more dynamic and efficient.

Anyone looking to centralize their Kuma uptime alerts, server scripts, or temperature sensor data will find ntfy a robust tool. Simply configure the public URL and access permissions correctly to enjoy a fully functional system. real-time notifications that does not depend on third parties and is extremely lightweight for both the server and the mobile device.