Guides

MokoNtfy — Hosted Push Notifications

Details
Category: Guides
  • Applicable Software: MokoNtfy

MokoNtfy is Moko Consulting's hosted push-notification service — our managed fork of the open-source ntfy project. It lets you send notifications to your phone, desktop, or scripts using nothing more than a simple HTTP PUT or POST request. It is ideal for alerting yourself when a backup finishes, a script fails, a server goes down, or any other event you care about.

Where it lives

MokoNtfy is hosted at ntfy.mokoconsulting.tech. The web app, REST API, and notification endpoints all run from that address.

Accounts & access

  • Sign-in is required to use the web app and to publish or subscribe.
  • Self-registration is disabled — accounts are provisioned by Moko Consulting. Contact us to have an account created.
  • Sign in with Google is supported. New Google sign-ins are held for administrator approval before access is granted.
  • Accounts use a tiered role model: owner › admin › user.

What you can do with it

  • Publish a message to a topic with a single HTTP request from any language or the command line.
  • Subscribe to topics from the web app, the Android/iOS app, or the ntfy CLI.
  • Add titles, priorities, tags/emojis, click actions, and file attachments to your messages.
  • Browser (web push) notifications are enabled — receive notifications in the background without keeping the ntfy tab focused (support varies by browser and OS).
  • Set a per-topic notification level: All messages, Important only (high/urgent priority only), or Muted.
  • Create access tokens for scripts, with a one-click Download as JSON to save a token safely at creation time.
  • Install the app (PWA) on desktop or phone for a standalone window, launcher icon, and unread badge.
  • Email notifications are available for message delivery.

First-run guided tour

The first time you sign in, MokoNtfy walks you through the interface with a short guided tour. You can replay it any time from Take the tour in the profile menu.

For administrators

Administrators get a dedicated Site Administration area (reached from the profile menu) for site-wide settings such as Branding and Google sign-up approvals. From Branding, an admin can change the displayed app name, theme colors, and the favicon/app icon live — no rebuild or restart required. See the Features articles for details.

Next steps

  • Read Subscribe to MokoNtfy to start receiving notifications on the web, your phone, or the CLI.
  • Read Publish messages with MokoNtfy to send your first notification.
  • See the MokoNtfy Release Notes — 01.04.00 for the latest changes.
Hits: 8

Publish Messages with MokoNtfy

Details
Category: Guides
  • Applicable Software: MokoNtfy

Publishing a notification is a single HTTP PUT or POST to your topic URL. The message is the request body. Because MokoNtfy requires authentication, include your credentials (or an access token) with each request.

Send a simple message

curl -u <username>:<password> \
  -d "Backup finished successfully" \
  https://ntfy.mokoconsulting.tech/mytopic

Using an access token instead of a password:

curl -H "Authorization: Bearer <token>" \
  -d "Backup finished successfully" \
  https://ntfy.mokoconsulting.tech/mytopic

Create an access token from Account › Access tokens in the web app. When you create a token you can Download as JSON to save its value, label, expiry, and base URL to a file — useful for storing it in a secrets manager, since the raw token isn't shown again later. Existing tokens offer the same JSON download.

Add a title, priority, and tags

curl -u <username>:<password> \
  -H "Title: Nightly backup" \
  -H "Priority: high" \
  -H "Tags: floppy_disk,white_check_mark" \
  -d "Backup finished successfully" \
  https://ntfy.mokoconsulting.tech/mytopic

From Python

import requests
requests.post(
    "https://ntfy.mokoconsulting.tech/mytopic",
    data="Backup finished successfully".encode("utf-8"),
    auth=("<username>", "<password>"),
    headers={"Title": "Nightly backup", "Priority": "high"},
)

More options

  • Priority — min, low, default, high, max. On a topic set to Important only, subscribers are notified for high and max messages.
  • Tags/emojis — the Tags header adds labels and emoji to the notification.
  • Click action — the Click header opens a URL when the notification is tapped.
  • Attachments — send a file with the --data-binary option and a Filename header.
  • Email — the Email header forwards the notification to an email address (email delivery is enabled on this instance).

For the full list of publishing options, see the upstream ntfy publishing documentation.

Hits: 8