Hosta Uptime Kuma på en Managed VPS: övervaka dina tjänster dygnet runt

Det Uptime Kuma övervakar

Uptime Kuma anropar dina tjänster med jämna mellanrum, så ofta som var 20:e sekund, sparar historiken över deras svar och meddelar dig så fort någon av dem slutar svara. Det används via ett webbgränssnitt som finns på flera språk.

• Monitorerna: HTTP och HTTPS, sökning efter ett nyckelord på sidan, JSON-förfrågan, TCP, WebSocket, ping, DNS-post, Docker-containrar och en ”push”-monitor för en schemalagd uppgift som själv rapporterar att den har körts.
• Aviseringarna: över 90 aviseringstjänster, bland annat Telegram, Discord, Slack och e-post.
• Statussidorna: flera publika sidor, var och en på en egen domän om du vill.
• Certifikaten: uppgifterna i HTTPS-certifikatet för varje övervakad tjänst.
• Kontot: tvåfaktorsautentisering, och körning via en proxy för de monitorer som behöver det.

Placera Uptime Kuma på en annan server än de tjänster den övervakar. På en separat maskin ser den avbrottet utifrån och skickar larmet medan dina tjänster ligger nere.

Det som MIT-licensen tillåter

Uptime Kuma publiceras under MIT-licensen. Den tillåter att använda, kopiera, ändra, sammanfoga, publicera, distribuera, vidarelicensiera och sälja programvaran, på ett villkor: upphovsrättsmeddelandet och licenstexten ska finnas kvar i varje kopia.

Du kan alltså köra Uptime Kuma i ditt företag, övervaka dina kunders tjänster och öppna statussidor åt dem, utan att köpa någon licens.

Installationen med Docker Compose

Dokumentationen för Uptime Kuma utgår från Docker Compose. På en server där Docker är installerat skapar du en mapp och hämtar den officiella filen:

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

Projektets fil publicerar port 3001 på alla serverns adresser. Bakom en omvänd proxy begränsar du den till den lokala adressen, som README-filen föreslå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 som publiceras på 127.0.0.1: Docker publicerar som standard på alla serverns adresser, före reglerna i brandväggen ufw. Lokalt nås Uptime Kuma bara via den omvända proxyn.
• En mapp data på en lokal disk: den innehåller databasen kuma.db, uppladdade filer och skärmbilder. Projektet avråder från NFS och andra nätverksfilsystem, eftersom SQLite behöver tillförlitliga fillås.
• Taggen 2 följer version 2 av Uptime Kuma, och steget till nästa huvudversion förblir ditt eget val.
• Avbilden 2-slim är lättare, omkring 185 MB att ladda ned mot 620 MB: den utelämnar Chromium och den inbyggda MariaDB som avbilden 2 innehåller. Avbilden 2 är den som projektet rekommenderar, och en ”Browser Engine”-monitor kräver då en extern Chromium med 2-slim.

Vid första starten öppnar du gränssnittet: en guide låter dig välja databas och sedan skapa administratörskontot. Aktivera tvåfaktorsautentisering redan vid första inloggningen.

Projektet anger varken minne eller processor: storleken beror på hur många tjänster som ska övervakas och hur ofta. På en Managed VPS beskriver du hur du tänker använda den, så rekommenderar vi lämplig storlek.

HTTPS och WebSocket: den omvända proxyn

På ett publikt nätverk kräver projektet HTTPS. Uptime Kuma bygger på WebSocket: den omvända proxyn måste vidarebefordra huvudena Upgrade och Connection. Den serveras i roten av en domän eller underdomän, och wikin avråder från undermappar som example.com/uptimekuma.

Med Caddy

Caddy hämtar och förnyar certifikatet på egen hand och vidarebefordrar WebSocket utan någon extra inställning:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

Med Nginx och 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 installerar sedan certifikatet från Let’s Encrypt och omdirigeringen till HTTPS, och förnyar därefter certifikatet på egen hand:

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

När Uptime Kuma bara nås via proxyn öppnar du dess inställningar, ”Settings”, ”Reverse Proxy”, ”HTTP Headers”, och sätter ”Trust Proxy” till ”Yes”: loggarna visar då besökarnas verkliga adress.

SQLite eller MariaDB

Sedan version 2 erbjuder Uptime Kuma tre databaser, som du väljer i guiden vid första starten:

Vill du bestämma valet i förväg, utan guiden, lägger du variablerna UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME och UPTIME_KUMA_DB_PASSWORD till tjänsten i compose.yaml.

Aviseringarna, e-post inräknad

En monitor är bara till nytta om larmet når dig. Ställ in dina kanaler under ”Settings”, ”Notifications”, skicka ett testmeddelande från var och en, och ha gärna två, till exempel en meddelandetjänst och e-post: om den ena ligger nere tar den andra över.

För e-post ansluter Uptime Kuma till en SMTP-server. På en VPS från Simafri går utskicken via ett autentiserat relä på port 587: adressen till ett e-postkonto som du redan har, eller Simafri Suite.

Säkerhetskopior och uppdateringar

Sedan version 2 är säkerhetskopiering av mappen data den enda metod som projektet stöder. Med SQLite eller den inbyggda MariaDB ryms allt där. En SQLite-databas som kopieras mitt under skrivning kan bli korrupt: stoppa containern medan du kopierar, och ta hänsyn till att monitorerna stannar med den.

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

Uppdatera

Projektets wiki anger två kommandon, från mappen med compose.yaml. Mappen data ligger kvar:

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

Läs versionsanteckningarna före varje uppdatering: vissa innehåller säkerhetsrättelser, som 2.5.9 från den 31 oktober 2026. En säkerhetskopia strax före ger dig en enkel väg tillbaka.

Steget från version 1 till version 2 kräver större omsorg: säkerhetskopiera mappen data med containern stoppad och låt migreringen gå färdigt, eftersom en avbruten migrering tvingar dig att återställa säkerhetskopian. Projektet har uppmätt omkring 7 minuter för 20 monitorer och 90 dagars historik, och betydligt längre på en blygsam maskin eller med fler monitorer.

Vem gör vad på en Managed VPS

Att självhosta innebär att sköta servern utöver applikationen. På en Managed VPS tar våra team hand om servern och följer din instans proaktivt; Uptime Kuma förblir din programvara, med sina inställningar och sina data.

Om du föredrar att våra team ingriper i själva applikationen faktureras den tjänsten per timme eller som fast pris, med en offert som lämnas före ingreppet.