Hoste Uptime Kuma på en Managed VPS: overvåg dine tjenester døgnet rundt

Hvad Uptime Kuma overvåger

Uptime Kuma kalder dine tjenester med jævne mellemrum, helt ned til hvert 20. sekund, gemmer historikken over deres svar og giver dig besked, så snart en af dem ikke længere svarer. Den bruges fra en webgrænseflade, som findes på flere sprog.

• Probes: HTTP og HTTPS, søgning efter et nøgleord på siden, JSON-forespørgsel, TCP, WebSocket, ping, DNS-record, Docker-containere og en «push»-probe til en planlagt opgave, der selv melder, at den er kørt.
• Alarmer: mere end 90 notifikationstjenester, blandt andet Telegram, Discord, Slack og e-mail.
• Statussider: flere offentlige sider, hver på sit eget domæne, hvis du ønsker det.
• Certifikater: oplysningerne om HTTPS-certifikatet for hver overvåget tjeneste.
• Kontoen: tofaktorgodkendelse og adgang via en proxy til de probes, der har brug for det.

Placér Uptime Kuma på en anden server end de tjenester, den overvåger. På en separat maskine ser den nedbruddet udefra og sender alarmen, mens dine tjenester ligger nede.

Hvad MIT-licensen tillader

Uptime Kuma udgives under MIT-licensen. Den tillader at bruge, kopiere, ændre, sammenflette, udgive, distribuere, underlicensiere og sælge softwaren på én betingelse: at bevare copyright-meddelelsen og licensteksten i enhver kopi.

Du kan altså køre Uptime Kuma i din virksomhed, overvåge dine kunders tjenester med den og åbne statussider for dem uden at skulle købe en licens.

Installation med Docker Compose

Dokumentationen til Uptime Kuma starter med Docker Compose. På en server, hvor Docker er installeret, opretter du en mappe og henter den officielle fil:

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml

Projektets fil publicerer port 3001 på alle serverens adresser. Bag en reverse proxy begrænser du den til den lokale adresse, som README'en foreslår:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "127.0.0.1:3001:3001"

docker compose up -d

• En port, der publiceres på 127.0.0.1: Docker publicerer som standard på alle serverens adresser, før firewallen ufw's regler. Lokalt nås Uptime Kuma kun via reverse proxyen.
• En mappe data på en lokal disk: den rummer databasen kuma.db, de uploadede filer og skærmbillederne. Projektet fraråder NFS og andre netværksfilsystemer, fordi SQLite har brug for pålidelige fillåse.
• Tagget 2 følger version 2 af Uptime Kuma, og overgangen til en senere hovedversion er fortsat dit eget valg.
• Imaget 2-slim er lettere, cirka 185 MB at hente mod 620 MB: det udelader Chromium og den indbyggede MariaDB, som imaget 2 indeholder. Imaget 2 er det, projektet anbefaler, og en «Browser Engine»-probe kræver så en ekstern Chromium med 2-slim.

Ved første opstart åbner du grænsefladen: en guide lader dig vælge database og derefter oprette administratorkontoen. Slå tofaktorgodkendelse til allerede ved første login.

Projektet opgiver hverken hukommelse eller processor: størrelsen afhænger af antallet af tjenester, der skal overvåges, og af den ønskede hyppighed. På en Managed VPS beskriver du blot din brug for os, og vi anbefaler den størrelse, der passer.

HTTPS og WebSocket: reverse proxyen

På et offentligt netværk kræver projektet HTTPS. Uptime Kuma bygger på WebSocket: reverse proxyen skal videresende headerne Upgrade og Connection. Den serveres i roden af et domæne eller subdomæne, og wikien fraråder undermapper som example.com/uptimekuma.

Med Caddy

Caddy henter og fornyer selv certifikatet og videresender WebSocket uden yderligere indstillinger:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

Med Nginx og Certbot

server {
    listen 80;
    server_name uptime.example.com;

    location / {
        proxy_pass         http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
        proxy_set_header   Host $host;
    }
}

Certbot installerer derefter certifikatet fra Let's Encrypt og omdirigeringen til HTTPS og fornyer derefter certifikatet af sig selv:

sudo certbot --nginx -d uptime.example.com

Når Uptime Kuma kun kan nås via proxyen, åbner du dens indstillinger, «Settings», «Reverse Proxy», «HTTP Headers», og sætter «Trust Proxy» til «Yes»: så viser logfilerne de besøgendes rigtige adresse.

SQLite eller MariaDB

Siden version 2 tilbyder Uptime Kuma tre databaser, som du vælger i guiden ved første opstart:

For at fastlægge valget på forhånd, uden at gå om guiden, tilføjes variablerne UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME og UPTIME_KUMA_DB_PASSWORD til tjenesten i compose.yaml.

Notifikationer, e-mail inklusive

En probe nytter kun, hvis alarmen når frem til dig. Opret dine kanaler under «Settings», «Notifications», send en testbesked fra hver af dem, og sørg for to, for eksempel en messenger og e-mail: hvis den ene falder ud, tager den anden over.

Til e-mail forbinder Uptime Kuma sig til en SMTP-server. På en Simafri VPS går afsendelsen gennem et autentificeret relay på port 587: adressen på en mailkonto, du allerede har, eller Simafri Suite.

Backup og opdateringer

Siden version 2 er backup af mappen data den eneste metode, projektet understøtter. Med SQLite eller den indbyggede MariaDB ligger alt der. En SQLite-database, der kopieres midt i en skrivning, kan blive ødelagt: stop containeren, mens du kopierer, vel vidende at probes stopper med den.

docker compose stop
tar -czf uptime-kuma-$(date +%F).tar.gz data
docker compose start

Opdatér

Projektets wiki giver to kommandoer, fra mappen med compose.yaml. Mappen data bliver, hvor den er:

docker compose pull
docker compose up -d --force-recreate

Læs versionsnoterne før hver opdatering: nogle indeholder sikkerhedsrettelser, som 2.5.9 fra den 31. oktober 2026. En backup lige før giver dig en enkel vej tilbage.

Overgangen fra version 1 til version 2 kræver mere omhu: tag backup af mappen data med containeren stoppet, og lad migreringen køre til ende, for en afbrudt migrering tvinger dig til at gendanne backuppen. Projektet har målt omkring 7 minutter for 20 probes og 90 dages historik, og langt mere på en beskeden maskine eller med flere probes.

Hvem gør hvad på en Managed VPS

Selvhosting kræver, at du holder serveren ud over selve applikationen. På en Managed VPS tager vores teams sig af serveren og følger din instans proaktivt; Uptime Kuma forbliver din software, med dens indstillinger og data.

Hvis du foretrækker, at vores teams griber ind i selve applikationen, faktureres den ydelse pr. time eller som fast pris, med et overslag oplyst før indgrebet.