Att hosta Checkmate på en Managed VPS innebär att bevakningen av dina webbplatser och servrar sker på en egen maskin, som våra team håller uppdaterad och bevakar dag och natt. Checkmate är en fri applikation med öppen källkod för övervakning, under AGPL-3.0-licensen: drifttid, svarstider, incidenter, larm och statussidor. Den här guiden följer den officiella Docker-avbilden i version v4.0.0, och vi körde varje kommando på en VPS från Simafri innan vi skrev den: installation med Docker Compose, HTTPS, det första kontot, övervakare och larm, säkerhetskopior och uppdateringar.
Av Simon Vasconcelos Lee
Publicerad den 17 november 2026Lästid: 12 minuter
ghcr.io/bluewave-labs/checkmate och MongoDB 8.0, med porten publicerad på 127.0.0.1 bakom en omvänd proxy med HTTPS.JWT_SECRET, ENCRYPTION_KEY och din offentliga adress i CLIENT_HOST, och lägg till NODE_ENV=production, som referensfilen utelämnar.mongodump och behåll din .env-fil, och uppdatera sedan genom att ändra avbildens tagg: migreringarna körs av sig själva vid starten.Checkmate kontrollerar dina tjänster med jämna mellanrum, registrerar varje svar och dess svarstid, och larmar dig när något slutar svara. Utvecklaren, BlueWave Labs, beskriver det som ett självhostat verktyg för att följa serverns hårdvara, drifttid, svarstider och incidenter i realtid.
Checkmate publiceras under GNU Affero General Public License, version 3 (AGPL-3.0). Du kan använda den kostnadsfritt, för dig själv, ditt företag eller dina kunder, kopiera den och ändra den.
Dess särskilda klausul gäller användning över nätverk: om du ändrar Checkmate och låter andra använda din ändrade version över nätverket måste du erbjuda dem dess källkod. Att köra den officiella avbilden oförändrad, som i den här guiden, medför ingen sådan skyldighet. Programvaran tillhandahålls utan garanti.
Dokumentationen sätter en blygsam nedre gräns: valfri Linux-VPS med 1 GB RAM eller mer. Den tillägger att MongoDB använder ungefär 400 MB på en instans som kontrollerar fler än 300 servrar varje minut.
Serverns storlek beror alltså på antalet övervakare, deras intervall och den historik du behåller. På en Managed VPS beskriver du din användning för oss, och vi rekommenderar rätt storlek.
Sedan version 3.10 levereras Checkmate som en enda avbild, ghcr.io/bluewave-labs/checkmate, som serverar både gränssnittet och API:et. MongoDB körs bredvid, i en egen container. På en server med Docker Engine och dess Compose-tillägg, installerade från Dockers förråd för Ubuntu, skapar du en mapp som /opt/checkmate och lägger denna compose.yaml i den, baserad på projektets referensfil:
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 två hemligheterna läggs i en .env-fil bredvid, som Docker Compose läser av sig själv. Skapa den läsbar enbart för root och starta sedan stacken:
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: referensfilen publicerar den utan adress, och Docker öppnar den då på alla serverns adresser. Publicerad lokalt nås den bara via den omvända proxyn.CLIENT_HOST är adressen som dina användare skriver in, med https://. Checkmate använder den för kontroller mellan ursprung och för länkarna i sina larm och e-postmeddelanden.NODE_ENV=production: README kräver den i verkliga driftsättningar. Utan den körs applikationen i utvecklingsläge, vilket stänger av API:ets begränsning av antalet anrop.ENCRYPTION_KEY är valfri i referensfilen. Den krypterar de hemligheter som Checkmate lagrar, och v4.0.0 kräver den för Docker-övervakare med TLS och för Checkmate Connect. Ange den från början: det är enklare än att lägga till den senare.latest och hämtar den vid varje start. Med ett fullständigt versionsnummer, här v4.0.0, väljer du själv när varje uppdatering sker.mongo-data rymmer alla dina data: övervakare, kontroller, användare och inställningar.Första starten kör databasmigreringarna; på vår test-VPS rapporterade applikationen sig frisk på under tio sekunder. För att kontrollera att den svarar:
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
Det första kommandot svarar 200. Det andra svarar "data":false så länge inget konto finns, och true när Superadmin har skapats.
Checkmate har inget standardkonto. Den första personen som registrerar sig blir Superadmin, så skapa ditt direkt efter första starten, innan du öppnar adressen för allmänheten. En SSH-tunnel för serverns port 52345 till din dator, på http://localhost:52345; lägg till -p och den SSH-port som anges i ditt kundområde.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate visar sin registreringssida.Från och med då är den offentliga registreringen stängd: på vår test-VPS skickades varje ny besökare till inloggningssidan, och registreringsadressen ledde också dit. Andra personer ansluter via inbjudan, från avsnittet Team i kontoinställningarna, med rollen User eller Admin. Inbjudan skickas via e-post, så den behöver SMTP-inställningarna nedan, och dess länk upphör att gälla efter en timme.
| Roll | Vad den kan göra |
|---|---|
| User | Se alla övervakare, översiktspanelen, kontroller, incidenter, statussidor och inställningar, utan att ändra något |
| Admin | Allt som en User kan, plus övervakare, aviseringskanaler, incidenter, underhållsfönster, statussidor, inbjudningar och globala inställningar, SMTP inräknat |
| Superadmin | Allt som en Admin kan, plus att skapa konton direkt, redigera en annan användare, ändra en roll eller ett lösenord |
Sedan v4.0.0 är taggar, statussidor och proxyer Admin-åtgärder: en User som tidigare kunde hantera dem förlorar den åtkomsten efter uppdateringen.
Containern serverar Checkmate över HTTP, på port 52345. HTTPS sköts av en omvänd proxy framför den: dokumentationen nämner Caddy, Traefik och nginx. Vi testade Caddy, installerat från dess officiella förråd för Debian och Ubuntu: det hämtar själv certifikatet från Let’s Encrypt, förnyar det och vidarebefordrar som standard huvudet Host och huvudena X-Forwarded-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST måste innehålla samma https://-adress som proxyn. När du har ändrat den kör du docker compose up -d för att återskapa containern.Larm och inbjudningar via e-post går genom en SMTP-anslutning för hela servern, som ställs in under ”Settings”, fliken ”Email”: server, port, användare, lösenord och avsändaradress, sedan ”Save” och ”Test”. Använd på en VPS från Simafri en autentiserad SMTP-server på port 587 eller 465: din domäns e-posttjänst eller en utskickstjänst. Skapa sedan en e-postavisering med adresserna som ska larmas, och koppla den till dina övervakare.
Slack, Discord, Teams, Telegram och de andra kanalerna skapas på samma sätt, under ”Notifications”, var och en med sin webhook-adress eller token, och var och en med en knapp ”Test”.
En heartbeat-övervakare bevakar ett jobb som körs av sig självt, som en nattlig säkerhetskopiering. Generera teamets ping-nyckel under ”Settings”, fliken ”Monitoring” (den visas bara en gång), skapa en Heartbeat-övervakare med en slug och ett larmfönster, och anropa sedan dess ping-adress i slutet av 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"
Om du lägger till /fail, eller jobbets avslutningskod, i adressen markeras övervakaren som nere direkt, utan att vänta på att fönstret går ut.
Under ”Status pages” publicerar en Admin en sida som listar utvalda övervakare och deras drifttid, för dina kunder eller ditt team. Sedan v4.0.0 har varje statussida en tidszon, UTC som standard.
Allt finns på två ställen: MongoDB-databasen, i volymen mongo-data, och din .env-fil. Förvara den senare säkert: ENCRYPTION_KEY behövs för att läsa de hemligheter som lagras i databasen, och JWT_SECRET håller dina användare inloggade. MongoDB-avbilden innehåller mongodump:
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak
Schemalägg den här kopian och skicka den bort från servern; en heartbeat-övervakare kan tala om för dig om den någon gång slutar köras. Lagrade på disken ingår arkiven också i serverns nattliga säkerhetskopior.
På samma eller en ny installation, med samma .env, stoppar du applikationen, läser in arkivet och startar den sedan 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 testade hela cykeln på vår VPS: säkerhetskopia, databasen faktiskt raderad, återställning. Övervakaren och kontot kom tillbaka, och inloggningen fungerade igen direkt.
Checkmate v4.0.0 erbjuder också krypterade säkerhetskopior i molnet via Checkmate Connect, en valfri tjänst, kostnadsfri under betaperioden, som kräver ENCRYPTION_KEY och en Superadmin för att registrera installationen. Kopiorna ovan fungerar utan den.
Läs versionsanteckningarna, ta en säkerhetskopia, ändra avbildens tagg i compose.yaml, hämta sedan den nya avbilden och återskapa containern. Databasmigreringarna körs av sig själva vid starten:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump och mongorestore. Ingen ny miljövariabel krävs.checkmate-client, checkmate-backend och checkmate-mongo, som inte längre uppdateras. Byt till ghcr.io/bluewave-labs/checkmate och behåll din MongoDB-tjänst och dess volym; variablerna UPTIME_APP_* läses inte längre.Checkmate skickar en anonym rapport om dagen: ett installations-id, versionen, hur den installerades och antalet övervakare av varje typ, aldrig dina adresser eller resultat. Den säger det i sin logg vid starten. För att stänga av den lägger du till TELEMETRY_ENABLED=false i miljön för tjänsten checkmate och kör sedan docker compose up -d.
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; Checkmate förblir din programvara, med sina övervakare och dina inställningar.
| Område | Våra team | Du |
|---|---|---|
| Servern | Uppdateringar av system och säkerhet, ingrepp på servern inräknade | Tidpunkten som passar din verksamhet |
| Övervakningen | Servern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtal | Dina egna övervakare, larm och statussidor i Checkmate |
| Checkmate | Proaktiv uppföljning: fel, långsamma svarstider, databas och diskutrymme upptäcks, med rekommenderad rättelse | Installationen, uppdateringarna och inställningarna, som du genomför själv eller med din AI-assistent |
| Användarna och larmen | Servern som bär dem, övervakad och säkerhetskopierad | Konton, roller, inbjudningar och aviseringskanaler |
| Säkerhetskopiorna | Varje natt, krypterade och förvarade utanför maskinen; återställning ingår | Checkmates egna databasexporter och begäran om återställning, när du behöver den |
| Migreringen | Din nuvarande server migreras kostnadsfritt | Tidpunkten för bytet |
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.
Med en Managed VPS från Simafri håller våra team servern för din Checkmate-instans uppdaterad, övervakar den dag och natt och griper in utan att vänta på ditt samtal; de följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv eller med din AI-assistent. Säkerhetskopiorna krypteras varje natt och förvaras utanför maskinen, återställningen ingår, och migreringen av din nuvarande server är kostnadsfri.
Ja. Checkmate omfattas av AGPL-3.0-licensen: du kan köra den för dig själv, ditt team eller dina kunder utan att köpa någon licens. Om du ändrar den och låter andra använda den över nätverket delar du dina ändringar. Det som återstår är kostnaden för servern som kör den.
Utgå från referensfilen compose.yaml: avbilden ghcr.io/bluewave-labs/checkmate och MongoDB 8.0. Lägg JWT_SECRET och ENCRYPTION_KEY i en .env-fil, ange din https-adress i CLIENT_HOST och production i NODE_ENV, publicera port 52345 på 127.0.0.1, kör docker compose up -d och placera en omvänd proxy med HTTPS framför.
Det finns inga. Den första personen som registrerar sig på en ny instans blir Superadmin. Skapa ditt konto direkt efter första starten, via en SSH-tunnel; därefter skickas besökare till inloggningssidan och nya användare ansluter via inbjudan.
Dokumentationen kräver en Linux-VPS med 1 GB RAM eller mer. På vår test-VPS använde en nyinstallation ungefär 300 MB för Checkmate och 280 MB för MongoDB. Disken växer med antalet övervakare, deras intervall och den historik du behåller, 90 dagar som standard.
Ställ in SMTP-anslutningen under Settings, fliken Email: server, port 587 eller 465, användare, lösenord och avsändare, sedan Save och Test. Skapa en e-postavisering med adresserna som ska larmas och koppla den till dina övervakare. Inbjudningarna använder samma inställningar.
Exportera MongoDB-databasen med docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db, och behåll en kopia av din .env-fil, vars ENCRYPTION_KEY behövs för att läsa de lagrade hemligheterna. Återställ med mongorestore --archive --gzip --drop, med applikationen stoppad.
Läs versionsanteckningarna och ta en säkerhetskopia, ändra avbildens tagg i compose.yaml, och kör sedan docker compose pull och docker compose up -d. Databasmigreringarna körs av sig själva vid starten.
En Managed VPS täcker servern: system, säkerhet, övervakning och säkerhetskopior. Våra team följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv. Ett ingrepp i själva applikationen faktureras per timme eller som fast pris.
Simafri
Låt oss prata om din webbplats
Berätta om ditt projekt med några ord: vi återkommer snabbt.
Tack! Din förfrågan har skickats. Vi återkommer till dig inom kort.
Föredrar du e-post? Skriv till oss på support@simafri.com.