Guides
Everything you need to send push notifications to your iPhone with NTF-AI, whether you use the free ntf-ai.app server or run your own.
Which server should I use?
NTF-AI works with ntf-ai.app out of the box, and with any ntfy server you run yourself. Most people should start with ntf-ai.app.
| ntf-ai.app | Your own server | |
|---|---|---|
| Setup | None | Docker, a domain and HTTPS (guide) |
| Instant notifications | Yes | Yes, with one config line |
| Who stores your messages | ntf-ai.app, for 12 hours | You, as long as you like |
| Private topics | Long random topic name, plus an optional topic password (end-to-end encryption) | The same, plus usernames, passwords and access tokens |
| Limits | 2,000 messages a day per IP address (all limits) | Yours to set |
| Cost | Free | Your hardware |
Common questions
Do I need the official ntfy app too?
No. NTF-AI is a complete ntfy client for iPhone and iPad. It is a separate, community-maintained app built on the open-source ntfy iOS client, and it has its own push channel, so it gets instant notifications from ntf-ai.app and from servers that relay to ntf-ai.app.
Can I keep using my ntfy.sh topics?
You can subscribe to them, but ntfy.sh sends instant pushes only to the official ntfy app. In NTF-AI, ntfy.sh topics update when you open the app or a topic. See server compatibility and push delivery for the limits of each server.
Does Apple or Google see my messages?
No. The push that wakes your phone carries only a topic identifier and a message ID. The app then fetches the message itself from the server over HTTPS. Messages sent with a topic password are encrypted before they leave the sender, so the server only ever holds ciphertext. Details: Privacy Policy.
What about Android, desktop and the web?
ntf-ai.app is a standard ntfy server. Use the web app in any browser, or the ntfy Android app with https://ntf-ai.app as the server. Any tool that publishes to ntfy (curl, the ntfy CLI, Home Assistant, Uptime Kuma, scripts) works too: use ntf-ai.app wherever its docs say ntfy.sh.
Notifications aren't arriving. What do I check?
- iPhone Settings → Notifications → NTF-AI: Allow Notifications is on.
- The topic in the app and the URL you send to match exactly, including the server (
https://ntf-ai.app/your-topic). - Open the topic in the app. If the message is there but no banner appeared, it is a notification setting; if it isn't there, the message never reached the server.
- On your own server, work through self-hosting troubleshooting.
Still stuck? See Support.