How to host Uptime Kuma on your own server
Uptime Kuma checks your sites and sends alerts when they go down. Zefily installs it from the catalog as a container with a domain and HTTPS, and keeps its data on the server. The first visit opens a setup screen, which the panel protects for you.
Before you start
- A server connected to Zefily with the web stack installed.
- A domain whose DNS points to the server.
- A list of the sites you want to monitor.
Steps
-
1. Open One-click apps
Open the server, choose Sites, and under One-click apps pick Uptime Kuma. The web stack must be installed first.
-
2. Enter the domain and install
Enter the domain, point its DNS to the server first, keep HTTPS on and click Install.
-
3. Read the temporary login
Uptime Kuma opens a setup screen on the first visit, so the panel keeps it behind its temporary access. Click Show admin login on the site, and copy the user name and password it shows.
-
4. Create your own admin account
Open the site, sign in with the temporary access, and create your admin account on the setup screen. The panel cannot create that account for you.
-
5. Add the first monitors
Add an HTTP monitor for each site. Under its settings, add a notification channel such as email or a chat, so the alerts reach you.
-
6. Keep it updated
Click Deploy now on the site to pull the newest image. Uptime Kuma 1 installs get the Update button, which moves them to version 2.
-
7. Add the site to a backup plan
Add the site to a backup plan before you update, so the monitor data can be restored if an update goes wrong.
Verify it works
The domain opens Uptime Kuma over HTTPS, you can sign in with your own admin account, and the monitor you added shows as up.
Troubleshooting
- The setup screen wants a login I do not have
- Use the temporary access: Show admin login gives the admin user and its password. Create your own account there.
- The install stops
- The site shows the reason and a Retry install button. Retry is safe: an installed app is only finished.
- Every monitor shows down
- Checks run from the server. Confirm the URL answers from the server itself, and that the monitor uses the address your visitors use.
Questions
Does Uptime Kuma need a big server?
It is a light container. The pre-flight check warns on servers under 1 GB of memory, and the other sites on the server share the same memory.
Which version does a new install get?
The newest image of Uptime Kuma 2. Installs made from Uptime Kuma 1 are moved to version 2 with Update.
Where do I find the admin login later?
On the site row: click Show admin login. The panel asks for your password first and writes the reveal to the audit log.
Read next
Start on a server you own
Create your account, connect a server and follow the guide. The server stays yours: you pay your provider.