Home

URSA Wiki

URSA is a native Android client for Uptime Kuma: watch your self-hosted monitors in real time, across multiple servers, with push notifications that need no relay server and no Google services.

This wiki has two sections. Pick the one that fits you.

For users

You want to install URSA and watch your servers from your phone.

• Installation - get the app onto your device
• Getting Started - the setup checklist: connect, log in, view
• Push Notifications - get alerted the moment a monitor goes down
• Troubleshooting - fixes for the common snags
• FAQ - quick answers

For developers

You want to build URSA, understand how it works, or contribute.

• Architecture - how the app is put together
• Building and Testing - toolchain and commands
• Network and Protocol - how URSA talks to Uptime Kuma
• Push Internals - the UnifiedPush receive path
• Security - the security posture in brief
• Contributing - conventions and how to get a change merged

What URSA is (and is not)

URSA is a client: it watches and reacts. It does not replace the Uptime Kuma web UI for configuration. You still create and edit monitors, notifications, and status pages in Kuma itself; URSA is where you keep an eye on them and act quickly.

• Native Android - Kotlin and Jetpack Compose.
• No relay server - push goes from your Kuma instance straight to your device.
• No Firebase - notifications ride UnifiedPush; you choose the distributor.
• Familiar - it uses Uptime Kuma's own colors and status conventions, with light and dark mode, so you do not have to relearn anything. Only the icons differ.