ntfy

ntfy is a simple pub/sub notification service. Minato publishes to a topic over HTTP — you subscribe to that topic in the ntfy app on any device.

Works with the public ntfy.sh server or any self-hosted ntfy instance.

1. Choose a server

ntfy.sh (public)

No account or setup needed. Use https://ntfy.sh as the server URL. Anyone who knows your topic name can subscribe to it, so pick something hard to guess (see Choosing a topic below).

Self-hosted

Point the server URL at your own instance, e.g. https://ntfy.example.com. Authentication requirements depend on how your server is configured.

2. Choose a topic

The topic is a string that acts as the channel name. Minato publishes to it; your ntfy app subscribes to it.

Choosing a topic

On a public server, any subscriber who knows the topic name receives your notifications. Use the generate button (↺) in the Minato channel form to produce a memorable, hard-to-guess slug:

smooth-cycles-post-2253
rare-streets-check-9186
floppy-kiwis-cross-8717

These are generated by combining three random words with a four-digit number, giving around 26 bits of entropy — enough to prevent casual discovery while staying easy to type on a phone.

If you're on a self-hosted instance with authentication, the topic name matters less because access is controlled by credentials.

3. Access token

The access token is a Bearer token that authorises Minato to publish to your topic. Whether you need one depends on your setup.

You need a token when:

• Your self-hosted ntfy server has auth-default-access: deny-all in its config, or the topic has explicit access restrictions. Unauthenticated publish requests will be rejected with 401 Unauthorized.
• You have reserved the topic on ntfy.sh under your account to prevent others from publishing to it. Reserving a topic requires an ntfy.sh account; once reserved, only requests carrying your access token are accepted.

You do not need a token when:

• Using ntfy.sh with an unreserved (public) topic — the common case for personal use.
• Your self-hosted server allows unauthenticated publishing.

To generate a token on ntfy.sh, go to Account → Access tokens after signing in.

4. Add the channel in Minato

Go to Dashboard → Notifications → Add channel, select ntfy, and fill in:

Select the events you want to receive and click Create.

Use the Test button (⚗) in the channel list to publish a sample message and confirm delivery.