Subscribe to MokoNtfy (Web, Phone, CLI)

Details
Category: Reference
  • Applicable Software: MokoNtfy

You receive notifications by subscribing to a topic. A topic is just a name you choose; anyone who can publish to that topic (and is signed in) can send you notifications. Because topic names are visible to other users on the server, choose a name that cannot be easily guessed.

Note: MokoNtfy requires you to be signed in. If you don't have an account yet, contact Moko Consulting — self-registration is disabled. You can also sign in with Google (new Google sign-ins are approved by an administrator).

Web app

  1. Open ntfy.mokoconsulting.tech and sign in.
  2. Click Subscribe to topic, type your topic name (for example mytopic), and confirm.
  3. Messages published to that topic now appear in the web app.

Navigation & layout

Your topics are listed in a sidebar on the left. Click the logo in the top-left corner to collapse or expand that sidebar — useful for more reading room, and your choice is remembered between visits. On wide screens the top-left shows the full MokoNtfy wordmark; on narrow screens it shows the compact icon. The sign-in page shows the same wordmark above the form.

Background (web push) notifications

Background notifications via Web Push are enabled on this instance. Turn them on per browser under Settings; once enabled, notifications arrive even when the ntfy tab isn't focused. Support depends on your browser and OS — Chrome, Edge, Firefox, and Opera on desktop (while the browser is running), Safari 16.1+ on macOS 13+, Android with the browser closed, and iOS 16.4+ when the app is added to the home screen. If you leave background notifications off, keep an ntfy tab open (pinning the tab works well).

Per-topic notification level

From a subscribed topic's menu you can choose how noisy it is:

  • All messages (default) — every message notifies.
  • Important only — only high/urgent priority messages notify; the rest are still stored, just quiet. Applies both in the foreground and to background web push.
  • Muted — nothing notifies, and the topic is dropped from web push entirely.

Install as an app (PWA)

MokoNtfy is installable on desktop and mobile. Use your browser's Install app or Add to Home Screen option to get a standalone window, a launcher icon, and an unread badge. On an installed app, background notifications are always on (you can still mute individual topics).

Phone (Android / iOS)

  1. Install the ntfy app from Google Play, F-Droid, or the App Store.
  2. In the app, add a subscription and set the server to https://ntfy.mokoconsulting.tech (change the Default server in the app settings, or choose "Use another server" when subscribing).
  3. Enter your username and password for MokoNtfy so the app can access your topics.
  4. Subscribe to your topic name.

Command line (ntfy CLI)

Install the ntfy CLI, then subscribe and pipe each message to a script:

ntfy subscribe \
  --user <username> \
  https://ntfy.mokoconsulting.tech/mytopic

You can also run a command for every incoming message:

ntfy subscribe mytopic 'notify-send "$message"'

Next step

See Publish messages with MokoNtfy to send your first notification to a topic.

Hits: 8