Hosta Checkmate på en Managed VPS: övervakning av drifttid på din egen server

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.

Simon Vasconcelos Lee Av Publicerad den 17 november 2026Lästid: 12 minuter

Alla guider

I korthet

  1. AGPL-3.0-licensen låter dig köra Checkmate 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.
  2. Installera med Docker Compose: allt-i-ett-avbilden ghcr.io/bluewave-labs/checkmate och MongoDB 8.0, med porten publicerad på 127.0.0.1 bakom en omvänd proxy med HTTPS.
  3. Ange JWT_SECRET, ENCRYPTION_KEY och din offentliga adress i CLIENT_HOST, och lägg till NODE_ENV=production, som referensfilen utelämnar.
  4. Den första personen som registrerar sig blir Superadmin: skapa ditt konto direkt efter första starten, sedan ansluter alla andra via inbjudan.
  5. Säkerhetskopiera MongoDB-databasen med mongodump och behåll din .env-fil, och uppdatera sedan genom att ändra avbildens tagg: migreringarna körs av sig själva vid starten.

Vad Checkmate gör

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.

Vad AGPL-3.0-licensen tillåter

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.

Resurserna att planera för

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.

Installation med Docker Compose

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:

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 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:

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ö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:

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

Det första kommandot svarar 200. Det andra svarar "data":false så länge inget konto finns, och true när Superadmin har skapats.

Det första kontot, roller och inbjudningar

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.

Terminal, på din dator
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Öppna http://localhost:52345: Checkmate visar sin registreringssida.
  2. Ange ditt förnamn, efternamn, din e-postadress och ett lösenord på minst 8 tecken, med en versal, en gemen, en siffra och ett specialtecken.
  3. Registrera dig: du hamnar på översiktspanelen, inloggad som Superadmin.

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.

RollVad den kan göra
UserSe alla övervakare, översiktspanelen, kontroller, incidenter, statussidor och inställningar, utan att ändra något
AdminAllt som en User kan, plus övervakare, aviseringskanaler, incidenter, underhållsfönster, statussidor, inbjudningar och globala inställningar, SMTP inräknat
SuperadminAllt 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.

HTTPS: den omvända proxyn

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-*.

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

Din första övervakare och dess larm

  1. Klicka under ”Uptime” på ”Create monitor” och välj HTTP/HTTPS.
  2. Ange adressen att kontrollera, ett namn som du känner igen i ett larm, och ett intervall: dokumentationen rekommenderar en till fem minuter för en kritisk tjänst.
  3. Spara: Checkmate kör den första kontrollen direkt. På vår test-VPS var övervakaren uppe en minut senare.

E-post: SMTP-inställningarna

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”.

Heartbeat-övervakare för dina schemalagda jobb

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:

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"

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.

Statussidor

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.

Säkerhetskopior

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:

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

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.

Återställning

På samma eller en ny installation, med samma .env, stoppar du applikationen, läser in arkivet och startar den sedan 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 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.

Uppdateringar

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:

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

Telemetri

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.

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; Checkmate förblir din programvara, med sina övervakare och dina inställningar.

OmrådeVåra teamDu
ServernUppdateringar av system och säkerhet, ingrepp på servern inräknadeTidpunkten som passar din verksamhet
ÖvervakningenServern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtalDina egna övervakare, larm och statussidor i Checkmate
CheckmateProaktiv uppföljning: fel, långsamma svarstider, databas och diskutrymme upptäcks, med rekommenderad rättelseInstallationen, uppdateringarna och inställningarna, som du genomför själv eller med din AI-assistent
Användarna och larmenServern som bär dem, övervakad och säkerhetskopieradKonton, roller, inbjudningar och aviseringskanaler
SäkerhetskopiornaVarje natt, krypterade och förvarade utanför maskinen; återställning ingårCheckmates egna databasexporter och begäran om återställning, när du behöver den
MigreringenDin nuvarande server migreras kostnadsfrittTidpunkten 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.

Checkmate, på en server som sköts åt dig

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.

Upptäck Managed VPS

Vanliga frågor

Är Checkmate gratis?

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.

Hur installerar jag Checkmate med Docker Compose?

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.

Vilka är standardinloggningsuppgifterna för Checkmate?

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.

Hur mycket minne behöver Checkmate?

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.

Hur skickar jag larm från Checkmate via e-post?

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.

Hur säkerhetskopierar jag Checkmate?

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.

Hur uppdaterar jag Checkmate?

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.

Täcker en Managed VPS Checkmate?

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.

Källor och officiell dokumentation

Kontakta oss