Push Notifications

Push Notifications

URSA delivers alerts through UnifiedPush, an open push standard. There is no relay server to run and nothing goes through Google or Firebase. You install a small "distributor" app once, and Uptime Kuma sends alerts straight to it.

How it works

Uptime Kuma  --(Webhook)-->  distributor (e.g. ntfy)  --(push)-->  URSA

When a monitor changes state, Kuma posts to your personal endpoint URL. The distributor delivers it to your phone, and URSA shows a notification.

Setup checklist

• Install a UnifiedPush distributor (ntfy is recommended)
• In URSA, open Push, allow notifications, and select the distributor
• Copy your endpoint URL (for ntfy, add ?up=1)
• Add a Webhook notification in Uptime Kuma using that URL
• Attach the notification to your monitors
• Test it

1. Install a distributor

The easiest choice is ntfy (open-source, free, self-hostable). Install it from F-Droid or Google Play. You do not need to create an account for basic use.

2. Register in URSA

Open Push from the monitor list. Allow notifications when asked (Android 13 and newer require this). Your installed distributor appears in the list; tap Use. URSA then shows your endpoint URL.

For ntfy, append ?up=1 to the endpoint so ntfy forwards Kuma's message unchanged.

3. Add the Webhook in Uptime Kuma

In the Uptime Kuma web app:

1. Go to Settings > Notifications > Setup Notification.
2. Notification Type: Webhook.
3. Post URL: paste your endpoint URL (with ?up=1 for ntfy).
4. Content Type: application/json.
5. Save, then enable this notification on the monitors you care about (or set it as a default for new monitors).

4. Test

Pause and resume a monitor, or briefly stop a monitored service, to trigger an event. You should get a notification within a few seconds.

If notifications do not arrive

See Troubleshooting.