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.
Af Simon Vasconcelos Lee
Udgivet den 17. november 2026Læsetid: 12 minutter
ghcr.io/bluewave-labs/checkmate og MongoDB 8.0, med porten publiceret på 127.0.0.1 bag en reverse proxy med HTTPS.JWT_SECRET, ENCRYPTION_KEY og din offentlige adresse i CLIENT_HOST, og tilføj NODE_ENV=production, som referencefilen udelader.mongodump, og gem din .env-fil; opdatér derefter ved at ændre imagets tag: migreringerne kører af sig selv ved opstart.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.
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.
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.
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:
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:
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
127.0.0.1: referencefilen publicerer den uden adresse, og Docker åbner den så på alle serverens adresser. Publiceret lokalt kan den kun nås gennem reverse proxyen.CLIENT_HOST er den adresse, dine brugere skriver, med https://. Checkmate bruger den til cross-origin-kontroller og til linkene i sine alarmer og e-mails.NODE_ENV=production: README beder om den ved rigtige installationer. Uden den kører applikationen i udviklingstilstand, som slår API'ets begrænsning af antallet af forespørgsler fra.ENCRYPTION_KEY er valgfri i referencefilen. Den krypterer de hemmeligheder, Checkmate gemmer, og v4.0.0 kræver den til TLS-Docker-monitorer og til Checkmate Connect. Sæt den fra starten: det er nemmere end at tilføje den senere.latest og henter det ved hver start. Med et fuldt versionsnummer, her v4.0.0, vælger du selv, hvornår hver opdatering sker.mongo-data rummer alle dine data: monitorer, kontroller, brugere og indstillinger.Første start kører databasemigreringerne; på vores test-VPS meldte applikationen sig sund på under ti sekunder. For at kontrollere, at den svarer:
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.
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.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate viser sin tilmeldingsside.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.
| Rolle | Hvad den kan |
|---|---|
| User | Se alle monitorer, dashboardet, kontroller, hændelser, statussider og indstillinger uden at ændre noget |
| Admin | Alt, hvad en User kan, plus monitorer, notifikationskanaler, hændelser, vedligeholdelsesvinduer, statussider, invitationer og globale indstillinger, SMTP inkluderet |
| Superadmin | Alt, 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.
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-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST skal indeholde den samme https://-adresse som proxyen. Når du har ændret den, skal du køre docker compose up -d for at genoprette containeren.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.
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:
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.
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.
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:
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.
På den samme eller en ny installation, med den samme .env, stopper du applikationen, indlæser arkivet og starter den derefter igen:
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.
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:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump og mongorestore. Ingen ny miljøvariabel er påkrævet.checkmate-client, checkmate-backend og checkmate-mongo, som ikke længere opdateres. Skift til ghcr.io/bluewave-labs/checkmate, og behold din MongoDB-tjeneste og dens volumen; variablerne UPTIME_APP_* læses ikke længere.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.
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.
| Emne | Vores teams | Dig |
|---|---|---|
| Serveren | Opdateringer af system og sikkerhed, indgreb på serveren inkluderet | Det tidspunkt, der passer til din drift |
| Overvågningen | Serveren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkald | Dine egne monitorer, alarmer og statussider i Checkmate |
| Checkmate | Proaktiv opfølgning: fejl, langsomme svartider, database og diskplads opdages, og en rettelse anbefales | Installation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent |
| Brugere og alarmer | Den server, der bærer dem, overvåget og sikkerhedskopieret | Konti, roller, invitationer og notifikationskanaler |
| Backup | Hver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderet | Checkmates egne databaseeksporter og anmodningen om gendannelse, når du får brug for den |
| Migreringen | Din nuværende server flyttes, uden beregning | Tidspunktet 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Lad os tale om din hjemmeside
Fortæl os om dit projekt med få ord: vi vender hurtigt tilbage til dig.
Tak! Din forespørgsel er sendt. Vi vender tilbage til dig hurtigst muligt.
Foretrækker du e-mail? Skriv til os på support@simafri.com.