MokoNtfy

MokoNtfy is Moko Consulting's hosted push-notification service — a fork of the open-source ntfy — for sending alerts to your phone, desktop, or scripts over simple HTTP PUT/POST. Hosted at ntfy.mokoconsulting.tech. Find guides for subscribing, publishing messages, and release notes here.

MokoNtfy — Hosted Push Notifications

Details
Category: MokoNtfy
  • 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.
  • Email notifications are available; browser (web push) notifications are not currently enabled on this instance.

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.

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.
Hits: 0

MokoNtfy Release Notes — 01.01.00

Details
Category: MokoNtfy
  • Applicable Software: MokoNtfy

MokoNtfy 01.01.00 — Stable

This is the first stable release of MokoNtfy, Moko Consulting's hosted fork of the open-source ntfy push-notification service, now live at ntfy.mokoconsulting.tech.

Highlights

  • MokoNtfy is live across the development, release-candidate, and production tiers, served from source by the Moko deployment pipeline.
  • Moko branding throughout the web app — login logo, favicons, app icons, and the MokoOnyx theme.
  • Sign-in required with accounts provisioned by Moko Consulting (self-registration disabled).
  • Email notifications enabled for message delivery.
  • Full upstream ntfy feature set: publish over HTTP PUT/POST; subscribe from the web app, phone apps, and CLI; titles, priorities, tags/emojis, click actions, and attachments.

Notes

  • Browser (web push) notifications are not enabled on this instance at this time.
  • MokoNtfy tracks upstream ntfy; see the ntfy documentation for the full feature reference.
Hits: 0

Publish Messages with MokoNtfy

Details
Category: MokoNtfy
  • 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

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.
  • 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: 0

Subscribe to MokoNtfy (Web, Phone, CLI)

Details
Category: MokoNtfy
  • 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.

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.

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: 0