Uptime Kuma: uptimemonitoring op je eigen server
Een zelfgehoste monitor die je sites en diensten elke minuut controleert en je meteen laat weten als er een niet meer reageert.
Over Uptime Kuma
Uptime Kuma is een opensourcetool voor monitoring, gestart door ontwikkelaar Louis Lam en inmiddels een van de zelfgehoste projecten met de meeste sterren op GitHub. Hij controleert of dingen reageren: websites via HTTP(S), trefwoorden op een pagina, TCP-poorten, ping, DNS-records, databases en meer.
Mislukt een controle, dan stuurt hij een melding via een van de tientallen ondersteunde kanalen, waaronder Telegram, Discord, Slack, e-mail en webhooks. Hij houdt ook responstijden bij, waarschuwt voordat TLS-certificaten verlopen en laat je openbare statuspagina's voor je klanten bouwen.
Mensen hosten hem zelf omdat hij licht en gratis is en een overzichtelijke interface heeft die je in een paar minuten instelt. Het belangrijkste detail is dat hij op een aparte server draait: een monitor op dezelfde machine als je site kan je niet vertellen dat die machine plat ligt.
Waarvoor mensen het gebruiken
Meldingen als een site plat gaat
Controleer je website en API elke minuut en krijg een bericht in Telegram of per e-mail zodra ze niet meer antwoorden.
Waarschuwingen voor verlopende certificaten
Krijg dagen van tevoren een herinnering voordat een HTTPS-certificaat verloopt, in plaats van het van klanten te horen.
Een openbare statuspagina
Laat klanten de actuele status van je diensten zien op een pagina die jij beheert.
Na je bestelling
Bij de eerste start van de server wordt Uptime Kuma geïnstalleerd en wordt poort 3001 in de firewall geopend, zodat de monitor bereikbaar is op http://jouw-serveradres:3001/. Bij het eerste bezoek maak je het beheerdersaccount aan, dus open het adres zodra de server klaar is. Voeg daarna je eerste monitor toe en koppel een meldingskanaal.
Waar je hem draait
Uptime Kuma controleert vanaf de plek waar hij draait. Een monitor op dezelfde server als de diensten die hij bewaakt, gaat samen met die diensten plat en kan je niet waarschuwen, dus houd hem op een andere server dan wat hij monitort.
Een eigen domein en HTTPS voor Uptime Kuma
Standaard antwoordt Uptime Kuma op het IP-adres van de server via gewoon HTTP. Wil je het een naam als status.example.com met certificaat geven, maak dan in je DNS een A-record voor die naam aan dat naar het IPv4-adres van de server wijst, en zet Caddy ervoor: Caddy haalt zelf een gratis Let's Encrypt-certificaat op en verlengt het. De commando's hieronder zijn voor Ubuntu 24.04, waarop onze app-servers draaien.
Open in het paneel TCP-poort 80 en 443 in de firewall van de server: Caddy heeft ze nodig om het Let's Encrypt-certificaat op te halen en de site te serveren.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
status.example.com {
reverse_proxy 127.0.0.1:3001
}
EOF
systemctl reload caddyMet een domein ervoor kun je de statuspagina's van Uptime Kuma met je klanten delen: maak een statuspagina aan, kies welke monitors erop staan en geef https://status.example.com/status/jouw-pagina door. Je kunt het domein ook in de instellingen van een statuspagina zelf aan die pagina koppelen.
Werkt het domein eenmaal, dan heeft niemand de kale poort 3001 nog nodig: verander in /opt/uptime-kuma/compose.yml "3001:…" in "127.0.0.1:3001:…", voer docker compose up -d uit en verwijder poort 3001 uit de firewall. Uptime Kuma is dan alleen nog via HTTPS bereikbaar.
Uptime Kuma bijwerken
De images in /opt/uptime-kuma/compose.yml staan vast op exacte versies, dus een gewone docker compose pull haalt opnieuw dezelfde versie op. Om bij te werken verander je de versie in de regel image: in de versie die je wilt (lees eerst de release notes), en daarna pull je de images en maak je de containers opnieuw aan. De data staat in Docker-volumes en blijft behouden.
cd /opt/uptime-kuma
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dEen back-up van Uptime Kuma maken
In het paneel kun je dagelijkse back-ups van de hele server aanzetten (+20% van de pakketprijs, de laatste 7 kopieën worden bewaard) en de server uit elk ervan herstellen. Een kopie van de eigen data van de app in een bestand blijft toch handig: die kun je naar een andere server verplaatsen of terugzetten zonder al het andere terug te draaien.
Monitors, meldingsinstellingen en de controlegeschiedenis staan in het volume uptime-kuma_uptime_kuma (/app/data). Stop de app even, zodat het databasebestand in een consistente staat wordt gekopieerd:
cd /opt/uptime-kuma && docker compose stop
docker run --rm -v uptime-kuma_uptime_kuma:/data -v /root:/backup alpine \
tar czf /backup/uptime-kuma-$(date +%F).tgz -C /data .
docker compose startZo werkt het
- Kies Uptime Kuma op de bestelpagina van de server en neem een pakket met genoeg geheugen.
- De app wordt bij de eerste start op de server geïnstalleerd, meestal binnen een paar minuten.
- Open de server in je paneel: daar staan het adres en de inloggegevens.