Monitor your websites with Uptime Kuma

Uptime Kuma checks your websites and services at a fixed interval and tells you when one stops answering. This guide takes you from ordering the app to your first monitor, a notification and a public status page.

What you need

• A Headpat Space account with a verified email address and your billing details filled in.
• The address of at least one website or service you want to watch.

It makes sense to run your monitoring somewhere other than the thing it watches. If your site and your monitor go down together, nobody tells you.

1. Order Uptime Kuma

1. Sign in to the panel, open Apps in the sidebar and click Create App.
2. Under Template, search for Uptime Kuma and select it.
3. Under Package, choose the package that fits you. You can switch to another package later.
4. Under Details, fill in a Display name, for example "Monitoring". If a Version field is shown, leave it on Latest (recommended).
5. Tick the box confirming that provisioning may start right away, click Deploy app and complete the payment.

The app is set up automatically. On the app page, the Access card shows the address of your Uptime Kuma. Wait until it says HTTPS active, then click Open.

2. Create the admin account

The panel does not create a login for Uptime Kuma. The first person who opens the address creates the admin account, so do this right after ordering.

1. If Uptime Kuma asks which database to use, choose SQLite and continue. That is the built-in option and needs no further settings.
2. Pick a language, a username and a strong password, and repeat the password.
3. Click Create.

Store the password in a password manager. The panel cannot show it or reset it for you.

Uptime Kuma is available in many languages. The names below are the English ones.

3. Add your first HTTP monitor

1. Click Add New Monitor at the top left.
2. Under Monitor Type, choose HTTP(s).
3. Give it a Friendly Name, for example "Shop homepage".
4. Under URL, enter the full address, including https://.
5. Leave Heartbeat Interval on the default of 60 seconds. That means one check per minute.
6. Set Retries to a low value such as 1 or 2. A single failed check then does not trigger an alert straight away.
7. Click Save.

The monitor appears in the list on the left. After the first check you see a green Up badge, the response time and a bar that gains one block per check.

Useful extras in the same form:

• Keyword as monitor type checks that a certain word is on the page. This catches pages that load but show an error.
• Certificate Expiry Notification warns you before the TLS certificate of your site expires.
• Accepted Status Codes defines which answers count as healthy. The default is 200 to 299.

4. Set up a notification

Without a notification you only see an outage when you happen to look at the dashboard.

1. Open your monitor and click Edit.
2. On the right, under Notifications, click Setup Notification.
3. Choose a Notification Type. Uptime Kuma supports email (SMTP), Discord, Telegram, webhooks and many more.
4. Fill in the fields for that type. For Discord that is a webhook URL from your channel settings. For email you need the SMTP details of your mailbox.
5. Click Test. You should receive a test message within a few seconds.
6. Switch on Default enabled so new monitors use this notification automatically. Switch on Apply on all existing monitors if you already have several.
7. Click Save in the notification window, then Save on the monitor.

You manage all notifications later under Settings and Notifications.

5. Create a public status page

A status page shows visitors whether your services are up, without giving them access to your dashboard.

1. Click Status Pages at the top, then New Status Page.
2. Enter a Name and a Slug. The slug becomes part of the address, for example status.
3. Click Next. You land in the editor.
4. Click Add Group and give the group a name, for example "Websites".
5. Use Add a monitor to pick the monitors that should be visible.
6. Add a title, a description and a logo if you like, then click Save.

The page is now reachable at the address of your app followed by /status/ and your slug. Anyone with the link can see it. Only add monitors whose names and status you are happy to show in public.

Have something to tell your visitors? Open the status page, click Edit Status Page and use Create Incident to pin a message to the top.

Use your own domain

A status page looks better on an address like status.example.com. See Connect your own domain to an app.

Good to know

• Monitors, history and settings are stored in the app. The panel backs them up for you: see Back up and restore your app.
• Very short intervals on many monitors make the history grow faster. One check per minute is enough for most sites.
• Turn on two-factor authentication under Settings and Security, because the login page is reachable from the internet.