Setup Guide

Get up and running with KumaAlert in minutes.

1

Download KumaAlert

Download KumaAlert from the App Store. The app requires iOS 17.0 or later.

2

Get Your Server URL

You'll need the URL of your Uptime Kuma instance. This is the address you use to access your dashboard in a web browser (e.g., https://status.example.com). Your server must be accessible from the internet — local network addresses won't work from your phone when you're away from home.

3

Connect to Your Server

Open KumaAlert and enter your server URL, username, and password. These are the same credentials you use to log into your Uptime Kuma dashboard. Tap Connect and you'll see your monitors appear.

4

Add an API Key (Optional)

For background status checks when the app isn't open, add an API key. In your Uptime Kuma dashboard, go to Settings > API Keys and create a new key. Then in KumaAlert, go to the Settings tab > Server and paste the key.

5

Enable Push Notifications

To receive alerts when monitors go down or recover, set up push notifications through your Uptime Kuma dashboard's notification system. The app will prompt you to allow notifications when you first connect.

Need help?

Visit our support page or email [email protected]