Quick Start: Your First Notification

Details
Category: Getting Started
  • Applicable Software: MokoNtfy

MokoNtfy is Moko Consulting's hosted push-notification service, live at ntfy.mokoconsulting.tech. You publish a message to a named topic, and anyone subscribed to that topic gets it — in the web app, the installed PWA, or a mobile app. This gets you from nothing to a first notification in a few minutes.

1. Subscribe to a topic (web / PWA)

Open ntfy.mokoconsulting.tech and click Subscribe to topic. Pick any name — a topic is created the first time it is used, so choose something hard to guess if it is not otherwise protected (e.g. alerts-8gk2). You will now see messages for that topic in the app.

To install it as an app, use your browser's Install / Add to Home Screen option — MokoNtfy is a PWA, so it installs to your desktop or phone and can deliver web-push notifications in the background.

2. Sign in (Google)

Signing in is optional for open topics but required for protected topics, reservations and admin features. Click Sign in and choose Sign in with Google. New Google accounts may need administrator approval before they can be used — if you land in a "pending approval" state, an admin approves you in Site Administration › Google Approvals.

3. Send your first notification

The simplest way is a one-line HTTP request. Publish to your topic by POSTing the message body to its URL:

curl -d "Hello from MokoNtfy" https://ntfy.mokoconsulting.tech/alerts-8gk2

Add a title and priority with headers:

curl \
  -H "Title: Backup finished" \
  -H "Priority: high" \
  -H "Tags: white_check_mark" \
  -d "Nightly backup completed in 4m12s" \
  https://ntfy.mokoconsulting.tech/alerts-8gk2

You can also publish straight from the web app with the Publish (pencil) button — type a message, optionally set a title, priority and tags, and send. The notification appears on every subscribed device.

Where Site Administration lives

If your account is an admin or owner, open the profile menu (top-right) and choose Site Administration (at /admin). That is where site-wide settings and access control live — users, topic access, groups, roles, branding, Google approvals and tours. See Site Administration Area for the full tour.

Next steps

  • Subscribe to MokoNtfy (Web, Phone, CLI) — more ways to receive.
  • Publish Messages with MokoNtfy — titles, priorities, tags, attachments and more.
  • Access Control & Roles — protect topics and delegate access.
Hits: 5