Uptime Kuma hosten op een Managed VPS: bewaak uw diensten continu

Wat Uptime Kuma bewaakt

Uptime Kuma vraagt uw diensten met vaste tussenpozen om een antwoord, tot elke 20 seconden, bewaart de geschiedenis van hun reacties en waarschuwt u zodra een dienst niet meer antwoordt. U gebruikt het via een webinterface, die in meerdere talen beschikbaar is.

• De monitors: HTTP en HTTPS, zoeken naar een trefwoord in de pagina, JSON-verzoeken, TCP, WebSocket, ping, DNS-records, Docker-containers, en een “push”-monitor voor een geplande taak die zelf meldt dat ze is uitgevoerd.
• De meldingen: meer dan 90 meldingsdiensten, waaronder Telegram, Discord, Slack en e-mail.
• De statuspagina's: meerdere openbare pagina's, elk op een eigen domein als u dat wilt.
• De certificaten: de gegevens van het HTTPS-certificaat van elke bewaakte dienst.
• Het account: tweestapsverificatie, en een proxy voor de monitors die er een nodig hebben.

Zet Uptime Kuma op een andere server dan de diensten die het bewaakt. Op een aparte machine ziet het de storing van buitenaf en verstuurt het de melding terwijl uw diensten stilliggen.

Wat de MIT-licentie toestaat

Uptime Kuma wordt gepubliceerd onder de MIT-licentie. Ze staat toe de software te gebruiken, te kopiëren, te wijzigen, samen te voegen, te publiceren, te verspreiden, in sublicentie te geven en te verkopen, onder één voorwaarde: de copyrightvermelding en de tekst van de licentie blijven in elke kopie staan.

U kunt Uptime Kuma dus in een bedrijf laten draaien, er de diensten van uw klanten mee bewaken en hun statuspagina's openen, zonder een licentie te kopen.

De installatie met Docker Compose

De documentatie van Uptime Kuma begint met Docker Compose. Maak op een server waar Docker is geïnstalleerd een map aan en haal het officiële bestand op:

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

Het bestand van het project publiceert poort 3001 op alle adressen van de server. Beperk haar achter een reverse proxy tot het lokale adres, zoals de README voorstelt:

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

• Een poort gepubliceerd op 127.0.0.1: Docker publiceert standaard op alle adressen van de server, vóór de regels van de ufw-firewall. Lokaal is Uptime Kuma alleen via de reverse proxy bereikbaar.
• Een map data op een lokale schijf: ze bewaart de database kuma.db, de verstuurde bestanden en de schermafbeeldingen. Het project raadt NFS en andere netwerkbestandssystemen af, omdat SQLite betrouwbare bestandsvergrendelingen nodig heeft.
• De tag 2 volgt versie 2 van Uptime Kuma, en de overstap naar een volgende hoofdversie blijft uw eigen keuze.
• De image 2-slim is lichter, ongeveer 185 MB om te downloaden tegenover 620 MB: ze laat Chromium en de ingebouwde MariaDB weg die de image 2 meebrengt. De image 2 is degene die het project aanbeveelt, en een “Browser Engine”-monitor vraagt met 2-slim een externe Chromium.

Open bij de eerste start de interface: een assistent laat u de database kiezen en daarna het beheerdersaccount aanmaken. Schakel tweestapsverificatie in bij de eerste aanmelding.

Het project noemt geen cijfers voor geheugen of processor: de grootte hangt af van het aantal te bewaken diensten en de gewenste frequentie. Beschrijf op een managed VPS uw gebruik aan ons, dan raden wij u de passende grootte aan.

HTTPS en WebSocket: de reverse proxy

Op een openbaar netwerk vraagt het project om HTTPS. Uptime Kuma draait op WebSocket: de reverse proxy moet de headers Upgrade en Connection doorgeven. Het wordt aangeboden op de root van een domein of subdomein, en de wiki raadt submappen zoals example.com/uptimekuma af.

Met Caddy

Caddy verkrijgt en vernieuwt het certificaat vanzelf en geeft WebSocket door zonder extra instelling:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

Met Nginx en 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 plaatst vervolgens het Let’s Encrypt-certificaat en de doorverwijzing naar HTTPS, en vernieuwt het certificaat daarna zelf:

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

Is Uptime Kuma alleen via de proxy bereikbaar, open dan de instellingen, “Settings”, “Reverse Proxy”, “HTTP Headers”, en zet “Trust Proxy” op “Yes”: de logboeken tonen dan het echte adres van de bezoekers.

SQLite of MariaDB

Sinds versie 2 biedt Uptime Kuma drie databases, te kiezen in de assistent van de eerste start:

Wilt u de keuze vooraf vastleggen, zonder de assistent, voeg dan de variabelen UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME en UPTIME_KUMA_DB_PASSWORD toe aan de dienst in compose.yaml.

Meldingen, e-mail inbegrepen

Een monitor heeft pas zin als de melding u bereikt. Stel uw kanalen in onder “Settings”, “Notifications”, stuur vanuit elk kanaal een testbericht en voorzie er twee, bijvoorbeeld een berichtendienst en e-mail: valt de ene uit, dan neemt de andere het over.

Voor e-mail verbindt Uptime Kuma met een SMTP-server. Op een Simafri-VPS loopt het verzenden via een geauthenticeerde relay, op poort 587: het adres van een e-mailaccount dat u al hebt, of Simafri Suite.

Back-ups en updates

Sinds versie 2 is een back-up van de map data de enige methode die het project ondersteunt. Met SQLite of de ingebouwde MariaDB zit alles erin. Een SQLite-database die tijdens het schrijven wordt gekopieerd, kan beschadigd raken: stop de container voor de duur van de kopie, wetende dat de monitors er dan mee stoppen.

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

Bijwerken

De wiki van het project geeft twee opdrachten, vanuit de map van compose.yaml. De map data blijft ongemoeid:

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

Lees de release-opmerkingen vóór elke update: sommige bevatten beveiligingsfixes, zoals 2.5.9 van 31 oktober 2026. Een back-up vlak ervoor geeft u een eenvoudige terugweg.

De overstap van versie 1 naar versie 2 vraagt meer zorg: maak een back-up van de map data terwijl de container gestopt is, en laat de migratie voltooien, want bij een onderbroken migratie moet u de back-up terugzetten. Het project mat ongeveer 7 minuten voor 20 monitors en 90 dagen geschiedenis, en veel meer op een bescheiden machine of met meer monitors.

Wie doet wat op een managed VPS

Self-hosting vraagt dat u naast de applicatie ook de server beheert. Op een managed VPS neemt ons team de server voor zijn rekening en houdt het uw instantie proactief in de gaten; Uptime Kuma blijft uw software, met zijn instellingen en gegevens.

Wilt u liever dat ons team in de applicatie zelf ingrijpt, dan wordt die dienstverlening per uur of tegen een vast bedrag gefactureerd, met een offerte voordat het werk begint.