Hoste Checkmate på en Managed VPS: oppetidsovervågning på din egen server

At hoste Checkmate på en Managed VPS betyder, at overvågningen af dine websites og servere kører på en maskine, der er din egen, og som vores teams holder opdateret og overvåger dag og nat. Checkmate er en fri, open source overvågningsapplikation under AGPL-3.0-licensen: oppetid, svartider, hændelser, alarmer og statussider. Denne guide følger det officielle Docker-image i version v4.0.0, og vi har kørt hver kommando på en VPS fra Simafri, før vi skrev den: installation med Docker Compose, HTTPS, den første konto, monitorer og alarmer, backup og opdateringer.

Simon Vasconcelos Lee Af Udgivet den 17. november 2026Læsetid: 12 minutter

Alle guider

Det vigtigste

  1. AGPL-3.0-licensen lader dig køre Checkmate for dig selv, dit team eller dine kunder uden at købe en licens; hvis du ændrer den og lader andre bruge den over netværket, deler du dine ændringer.
  2. Installér med Docker Compose: alt-i-ét-imaget ghcr.io/bluewave-labs/checkmate og MongoDB 8.0, med porten publiceret på 127.0.0.1 bag en reverse proxy med HTTPS.
  3. Sæt JWT_SECRET, ENCRYPTION_KEY og din offentlige adresse i CLIENT_HOST, og tilføj NODE_ENV=production, som referencefilen udelader.
  4. Den første person, der tilmelder sig, bliver Superadmin: opret din konto lige efter første start, derefter kommer alle andre med via invitation.
  5. Tag backup af MongoDB-databasen med mongodump, og gem din .env-fil; opdatér derefter ved at ændre imagets tag: migreringerne kører af sig selv ved opstart.

Hvad Checkmate gør

Checkmate kontrollerer dine tjenester med faste mellemrum, registrerer hvert svar og dets svartid og advarer dig, når noget holder op med at svare. Udvikleren, BlueWave Labs, beskriver det som et selvhostet værktøj til at følge serverhardware, oppetid, svartider og hændelser i realtid.

Hvad AGPL-3.0-licensen tillader

Checkmate udgives under GNU Affero General Public License, version 3 (AGPL-3.0). Du kan bruge den gratis, for dig selv, din virksomhed eller dine kunder, kopiere den og ændre den.

Dens særlige klausul gælder brug over netværket: hvis du ændrer Checkmate og lader andre bruge din ændrede version over netværket, skal du tilbyde dem dens kildekode. At køre det officielle image uændret, som i denne guide, skaber ingen sådan forpligtelse. Softwaren leveres uden garanti.

De ressourcer, du skal regne med

Dokumentationen sætter et beskedent minimum: en hvilken som helst Linux-VPS med 1 GB RAM eller mere. Den tilføjer, at MongoDB bruger omkring 400 MB på en instans, der kontrollerer mere end 300 servere hvert minut.

Serverens størrelse afhænger altså af antallet af monitorer, deres interval og den historik, du gemmer. På en Managed VPS beskriver du din brug for os, og vi anbefaler dig den rette størrelse.

Installation med Docker Compose

Siden version 3.10 leveres Checkmate som ét image, ghcr.io/bluewave-labs/checkmate, der leverer både grænsefladen og API'et. MongoDB kører ved siden af, i sin egen container. Opret på en server med Docker Engine og dets Compose-plugin, installeret fra Dockers repository til Ubuntu, en mappe som /opt/checkmate, og læg denne compose.yaml i den, bygget på projektets referencefil:

compose.yaml
services:
  checkmate:
    image: ghcr.io/bluewave-labs/checkmate:v4.0.0
    restart: always
    ports:
      - "127.0.0.1:52345:52345"
    environment:
      - DB_CONNECTION_STRING=mongodb://mongodb:27017/uptime_db
      - CLIENT_HOST=https://status.example.com
      - JWT_SECRET=${JWT_SECRET:?set JWT_SECRET in .env}
      - ENCRYPTION_KEY=${ENCRYPTION_KEY:?set ENCRYPTION_KEY in .env}
      - NODE_ENV=production
    stop_grace_period: 60s
    healthcheck:
      test: ["CMD", "node", "-e", "require('http').get('http://localhost:52346/livez',r=>process.exit(r.statusCode===200?0:1)).on('error',()=>process.exit(1))"]
      interval: 15s
      timeout: 3s
      start_period: 60s
      start_interval: 2s
      retries: 3
    depends_on:
      mongodb:
        condition: service_healthy

  mongodb:
    image: mongo:8.0
    restart: always
    command: ["mongod", "--quiet", "--bind_ip_all"]
    volumes:
      - mongo-data:/data/db
    healthcheck:
      test: ["CMD", "bash", "-c", "exec 3<>/dev/tcp/127.0.0.1/27017"]
      interval: 5s
      timeout: 30s
      start_period: 0s
      start_interval: 1s
      retries: 30

volumes:
  mongo-data:

De to hemmeligheder lægges i en .env-fil ved siden af, som Docker Compose læser af sig selv. Opret den, så kun root kan læse den, og start derefter stakken:

Terminal, i /opt/checkmate
umask 077
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -base64 32)" > .env
umask 022
docker compose up -d
docker compose ps

Første start kører databasemigreringerne; på vores test-VPS meldte applikationen sig sund på under ti sekunder. For at kontrollere, at den svarer:

Terminal
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:52345/
curl -s http://127.0.0.1:52345/api/v1/auth/users/superadmin

Den første kommando svarer 200. Den anden svarer "data":false, så længe der ikke findes nogen konto, og true, når Superadmin er oprettet.

Den første konto, roller og invitationer

Checkmate har ingen standardkonto. Den første person, der tilmelder sig, bliver Superadmin, så opret din lige efter første start, før du åbner adressen for offentligheden. En SSH-tunnel henter serverens port 52345 til din computer, på http://localhost:52345; tilføj -p og den SSH-port, der står i dit kundeområde.

Terminal, på din computer
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Åbn http://localhost:52345: Checkmate viser sin tilmeldingsside.
  2. Indtast dit fornavn, efternavn, din e-mailadresse og en adgangskode på mindst 8 tegn, med et stort bogstav, et lille bogstav, et tal og et specialtegn.
  3. Tilmeld dig: du lander på dashboardet, logget ind som Superadmin.

Fra da af er offentlig tilmelding lukket: på vores test-VPS blev hver ny besøgende sendt til loginsiden, og tilmeldingsadressen førte også dertil. Andre kommer med via invitation, fra afsnittet Team i kontoindstillingerne, med rollen User eller Admin. Invitationen sendes via e-mail, så den kræver SMTP-indstillingerne nedenfor, og dens link udløber efter en time.

RolleHvad den kan
UserSe alle monitorer, dashboardet, kontroller, hændelser, statussider og indstillinger uden at ændre noget
AdminAlt, hvad en User kan, plus monitorer, notifikationskanaler, hændelser, vedligeholdelsesvinduer, statussider, invitationer og globale indstillinger, SMTP inkluderet
SuperadminAlt, hvad en Admin kan, plus at oprette konti direkte, redigere en anden bruger, ændre en rolle eller en adgangskode

Siden v4.0.0 er tags, statussider og proxyer Admin-handlinger: en User, der kunne administrere dem før, mister den adgang efter opdateringen.

HTTPS: reverse proxyen

Containeren leverer Checkmate over HTTP, på port 52345. HTTPS håndteres af en reverse proxy foran den: dokumentationen nævner Caddy, Traefik og nginx. Vi har testet Caddy, installeret fra dets officielle repository til Debian og Ubuntu: det henter selv certifikatet fra Let’s Encrypt, fornyer det og videresender som standard headeren Host og headerne X-Forwarded-*.

/etc/caddy/Caddyfile
status.example.com {
	reverse_proxy 127.0.0.1:52345
}
Terminal
sudo systemctl reload caddy

Din første monitor og dens alarmer

  1. Klik i «Uptime» på «Create monitor», og vælg HTTP/HTTPS.
  2. Indtast den adresse, der skal kontrolleres, et navn, du vil genkende i en alarm, og et interval: dokumentationen anbefaler et til fem minutter for en kritisk tjeneste.
  3. Gem: Checkmate kører den første kontrol med det samme. På vores test-VPS var monitoren oppe et minut senere.

E-mail: SMTP-indstillingerne

E-mailalarmer og invitationer går gennem en SMTP-forbindelse for hele serveren, der sættes under «Settings», fanen «Email»: vært, port, bruger, adgangskode og afsenderadresse, derefter «Save» og «Test». Brug på en VPS fra Simafri en godkendt SMTP-server på port 587 eller 465: dit domænes mailtjeneste eller en afsendelsestjeneste. Opret derefter en e-mailnotifikation med de adresser, der skal alarmeres, og knyt den til dine monitorer.

Slack, Discord, Teams, Telegram og de andre kanaler oprettes på samme måde, under «Notifications», hver med sin webhook-adresse eller sit token og hver med en «Test»-knap.

Heartbeat-monitorer til dine planlagte job

En heartbeat-monitor overvåger et job, der kører af sig selv, såsom en natlig backup. Generér teamets ping-nøgle under «Settings», fanen «Monitoring» (den vises kun én gang), opret en Heartbeat-monitor med en slug og et alarmvindue, og kald derefter dens ping-URL i slutningen af jobbet:

crontab
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 "https://status.example.com/api/v1/heartbeat/<ping-key>/nightly-backup"

Tilføjer du /fail eller jobbets exitkode til URL'en, markeres monitoren som nede med det samme, uden at vente på, at vinduet udløber.

Statussider

Under «Status pages» udgiver en Admin en side, der viser udvalgte monitorer og deres oppetid, for dine kunder eller dit team. Siden v4.0.0 har hver statusside en tidszone, UTC som standard.

Backup

Alt ligger to steder: MongoDB-databasen, i volumen mongo-data, og din .env-fil. Opbevar sidstnævnte sikkert: ENCRYPTION_KEY er nødvendig for at læse de hemmeligheder, der er gemt i databasen, og JWT_SECRET holder dine brugere logget ind. MongoDB-imaget indeholder mongodump:

Terminal, i /opt/checkmate
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak

Planlæg denne kopi, og send den væk fra serveren; en heartbeat-monitor kan fortælle dig, hvis den nogensinde holder op med at køre. Gemt på disken indgår arkiverne også i serverens natlige backup.

Gendannelse

På den samme eller en ny installation, med den samme .env, stopper du applikationen, indlæser arkivet og starter den derefter igen:

Terminal, i /opt/checkmate
docker compose stop checkmate
docker compose exec -T mongodb mongorestore --archive --gzip --drop < checkmate-2026-11-17.archive.gz
docker compose start checkmate

Vi har testet hele cyklussen på vores VPS: backup, databasen faktisk slettet, gendannelse. Monitoren og kontoen kom tilbage, og login virkede igen med det samme.

Checkmate v4.0.0 tilbyder også krypteret backup i skyen via Checkmate Connect, en valgfri tjeneste, gratis i betaperioden, som kræver ENCRYPTION_KEY og en Superadmin for at tilmelde installationen. Kopierne ovenfor fungerer uden den.

Opdateringer

Læs udgivelsesnoterne, tag en backup, ændr imagets tag i compose.yaml, og hent derefter det nye image og genopret containeren. Databasemigreringerne kører af sig selv ved opstart:

Terminal, i /opt/checkmate
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration

Telemetri

Checkmate sender én anonym rapport om dagen: et installations-id, versionen, hvordan den blev installeret, og antallet af monitorer af hver type, aldrig dine URL'er eller resultater. Det oplyser den i sin log ved opstart. For at slå det fra tilføjer du TELEMETRY_ENABLED=false til miljøet for tjenesten checkmate og kører derefter docker compose up -d.

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; Checkmate forbliver din software, med dens monitorer og dine indstillinger.

EmneVores teamsDig
ServerenOpdateringer af system og sikkerhed, indgreb på serveren inkluderetDet tidspunkt, der passer til din drift
OvervågningenServeren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkaldDine egne monitorer, alarmer og statussider i Checkmate
CheckmateProaktiv opfølgning: fejl, langsomme svartider, database og diskplads opdages, og en rettelse anbefalesInstallation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent
Brugere og alarmerDen server, der bærer dem, overvåget og sikkerhedskopieretKonti, roller, invitationer og notifikationskanaler
BackupHver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderetCheckmates egne databaseeksporter og anmodningen om gendannelse, når du får brug for den
MigreringenDin nuværende server flyttes, uden beregningTidspunktet for omlægningen

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.

Checkmate på en server, der passes for dig

Med en Managed VPS fra Simafri holder vores teams serveren bag din Checkmate-instans opdateret, overvåger den dag og nat og griber ind uden at vente på dit opkald; de følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører, selv eller med din AI-assistent. Backup krypteres hver nat og opbevares uden for maskinen, gendannelsen er inkluderet, og migreringen af din nuværende server sker uden beregning.

Opdag Managed VPS

Ofte stillede spørgsmål

Er Checkmate gratis?

Ja. Checkmate er under AGPL-3.0-licensen: du kan køre det for dig selv, dit team eller dine kunder uden at købe en licens. Hvis du ændrer det og lader andre bruge det over netværket, deler du dine ændringer. Tilbage står udgiften til den server, der kører det.

Hvordan installerer jeg Checkmate med Docker Compose?

Brug referencefilen compose.yaml: imaget ghcr.io/bluewave-labs/checkmate og MongoDB 8.0. Læg JWT_SECRET og ENCRYPTION_KEY i en .env-fil, sæt CLIENT_HOST til din https-adresse og NODE_ENV til production, publicér port 52345 på 127.0.0.1, kør docker compose up -d, og sæt en reverse proxy med HTTPS foran.

Hvad er standardloginoplysningerne til Checkmate?

Der er ingen. Den første person, der tilmelder sig på en ny instans, bliver Superadmin. Opret din konto lige efter første start, gennem en SSH-tunnel; derefter sendes besøgende til loginsiden, og nye brugere kommer med via invitation.

Hvor meget hukommelse kræver Checkmate?

Dokumentationen beder om en Linux-VPS med 1 GB RAM eller mere. På vores test-VPS brugte en ny installation omkring 300 MB til Checkmate og 280 MB til MongoDB. Disken vokser med antallet af monitorer, deres interval og den historik, du gemmer, 90 dage som standard.

Hvordan sender jeg Checkmate-alarmer via e-mail?

Sæt SMTP-forbindelsen under Settings, fanen Email: vært, port 587 eller 465, bruger, adgangskode og afsender, derefter Save og Test. Opret en e-mailnotifikation med de adresser, der skal alarmeres, og knyt den til dine monitorer. Invitationer bruger de samme indstillinger.

Hvordan tager jeg backup af Checkmate?

Eksportér MongoDB-databasen med docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db, og gem en kopi af din .env-fil, da dens ENCRYPTION_KEY er nødvendig for at læse de gemte hemmeligheder. Gendan med mongorestore --archive --gzip --drop, mens applikationen er stoppet.

Hvordan opdaterer jeg Checkmate?

Læs udgivelsesnoterne, og tag en backup, ændr imagets tag i compose.yaml, og kør derefter docker compose pull og docker compose up -d. Databasemigreringerne kører af sig selv ved opstart.

Dækker en Managed VPS Checkmate?

En Managed VPS dækker serveren: system, sikkerhed, overvågning og backup. Vores teams følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører. Et indgreb i selve applikationen faktureres pr. time eller som fast pris.

Kilder og officiel dokumentation

Kontakt os