Documentation

Phone Alerts (ntfy)

This page is also in the Groundskeeper wiki: https://github.com/rsjsoftwareltd/groundskeeper/wiki/Phone-Alerts-ntfy

Email and Teams alerts depend on Microsoft. On a day when Outlook and Teams are down, an alert sent that way goes nowhere -- exactly when you most need it. Phone alerts send a short push message straight to a technician's phone through ntfy, a free, open-source notification service, so an alert still reaches you.

Set it up #

  1. On each phone that should get alerts, install the free ntfy app (iPhone or Android).
  2. In Groundskeeper, go to Settings -> Notifications and find the Phone push (ntfy) card.
  3. Switch on Enable phone push alerts and click Save phone push settings. Groundskeeper makes a long random topic for you and shows it in the Topic box.
  4. Click Copy, then in the ntfy app choose Subscribe to topic and paste it in. Leave the server as the default (ntfy.sh) unless you run your own.
  5. Click Send test message. A message should appear on the phone within a few seconds.

What is sent #

By default only the alert title and how serious it is leave your network, for example "Core switch is down" with a note that it is a critical alert. Switch Send the title only off if you also want the detail line sent.

Microsoft 365 outages are always sent #

Whatever you choose above, a Microsoft 365 Service Health alert about Exchange (Outlook) or Teams is always sent to the phone, because those are the services your email and Teams alerts depend on. Other Microsoft 365 services follow the normal rules.

Keeping it private #

On the free public server, the topic is the password: anyone who knows it can read your alerts. So Groundskeeper makes a long random one and will not accept a short topic there unless you use an access token. Treat the topic like a password: do not post it anywhere.

Two ways to make it safer:

If a message does not arrive #

Where it is stored #

Under notifications.ntfy in config.yaml, so a settings backup carries it.

Last updated: 2026-11-12

Last updated: 2026-11-13 (v0.196.6)