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
• Wear OS - alerts on your wrist and a glanceable status tile
• 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 focused client, not a second server. It watches and reacts, provides safe common monitor and maintenance management, and leaves account, database, API-key, Docker-host, remote-browser, and other server administration in Kuma.

• 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.
• Private access - encrypted per-server custom headers work with Pangolin, Cloudflare Access, and similar reverse-proxy gates.
• Free throughout - no ads, analytics, paywalls, subscription, or premium tier.