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.

Notify from your computerCommands and recipes for scripts, servers, Windows, Python and Home Assistant. Quick startInstall the app, pick a topic, send your first notification with one curl command. About 2 minutes. Release notesShipped updates and release dates for NTF-AI. Self-hostingRun your own ntfy server with Docker and get instant notifications in NTF-AI. CompatibilityPublic servers, self-hosting and iOS push delivery. Agent guideNotifications and answers for AI agents: questions with buttons, written replies, the ntf command and MCP server.

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.appYour own server
SetupNoneDocker, a domain and HTTPS (guide)
Instant notificationsYesYes, with one config line
Who stores your messagesntf-ai.app, for 12 hoursYou, as long as you like
Private topicsLong random topic name, plus an optional topic password (end-to-end encryption)The same, plus usernames, passwords and access tokens
Limits2,000 messages a day per IP address (all limits)Yours to set
CostFreeYour 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?
  1. iPhone Settings → Notifications → NTF-AI: Allow Notifications is on.
  2. The topic in the app and the URL you send to match exactly, including the server (https://ntf-ai.app/your-topic).
  3. 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.
  4. On your own server, work through self-hosting troubleshooting.

Still stuck? See Support.