Checkmate hosten op een Managed VPS: uptime-monitoring op uw eigen server

Checkmate hosten op een Managed VPS betekent dat de bewaking van uw websites en servers op een machine draait die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. Checkmate is een vrije, open source monitoringapplicatie onder de AGPL-3.0-licentie: uptime, responstijden, incidenten, meldingen en statuspagina’s. Deze gids volgt de officiële Docker-image in versie v4.0.0, en we hebben elke opdracht op een VPS van Simafri uitgevoerd voordat we hem schreven: de installatie met Docker Compose, HTTPS, het eerste account, de monitors en meldingen, back-ups en updates.

Simon Vasconcelos Lee Door Gepubliceerd op 17 november 2026Leestijd: 12 minuten

Alle gidsen

In het kort

  1. Dankzij de AGPL-3.0-licentie draait u Checkmate voor uzelf, uw team of uw klanten zonder een licentie te kopen; als u het wijzigt en anderen het via het netwerk laat gebruiken, deelt u uw wijzigingen.
  2. Installeer het met Docker Compose: de alles-in-één-image ghcr.io/bluewave-labs/checkmate en MongoDB 8.0, met de poort gepubliceerd op 127.0.0.1 achter een reverse proxy met HTTPS.
  3. Stel JWT_SECRET, ENCRYPTION_KEY en uw openbare adres in CLIENT_HOST in, en voeg NODE_ENV=production toe, dat het referentiebestand weglaat.
  4. De eerste persoon die zich registreert, wordt Superadmin: maak uw account aan direct na de eerste start, daarna komt iedereen binnen via een uitnodiging.
  5. Maak een back-up van de MongoDB-database met mongodump en bewaar uw bestand .env, en werk daarna bij door de tag van de image te wijzigen: de migraties lopen vanzelf bij het opstarten.

Wat Checkmate doet

Checkmate controleert uw diensten met vaste tussenpozen, registreert elk antwoord en de responstijd ervan, en waarschuwt u wanneer iets niet meer antwoordt. Zijn ontwikkelaar, BlueWave Labs, beschrijft het als een self-hosted hulpmiddel om de hardware van servers, de uptime, de responstijden en de incidenten in realtime te volgen.

Wat de AGPL-3.0-licentie toestaat

Checkmate wordt gepubliceerd onder de GNU Affero General Public License, versie 3 (AGPL-3.0). U kunt het kosteloos gebruiken, voor uzelf, uw bedrijf of uw klanten, en het kopiëren en wijzigen.

De bijzondere clausule ervan betreft het gebruik via het netwerk: als u Checkmate wijzigt en andere mensen uw gewijzigde versie via het netwerk laat gebruiken, moet u hun de broncode ervan aanbieden. De officiële image ongewijzigd draaien, zoals in deze gids, schept geen enkele verplichting van die aard. De software wordt geleverd zonder garantie.

De middelen waarmee u rekent

De documentatie legt een bescheiden ondergrens vast: elke Linux-VPS met 1 GB RAM of meer. Ze voegt eraan toe dat MongoDB ongeveer 400 MB gebruikt op een instantie die elke minuut meer dan 300 servers controleert.

De grootte van de server hangt dus af van het aantal monitors, hun interval en de geschiedenis die u bewaart. Op een managed VPS beschrijft u ons uw gebruik, en wij raden u de juiste grootte aan.

De installatie met Docker Compose

Sinds versie 3.10 wordt Checkmate geleverd als één enkele image, ghcr.io/bluewave-labs/checkmate, die zowel de interface als de API serveert. MongoDB draait ernaast, in een eigen container. Maak op een server met Docker Engine en zijn Compose-plug-in, geïnstalleerd vanuit de repository van Docker voor Ubuntu, een map aan zoals /opt/checkmate en zet daarin deze compose.yaml, gebaseerd op het referentiebestand van het project:

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 twee geheimen gaan in een bestand .env ernaast, dat Docker Compose vanzelf inleest. Maak het aan zodat alleen root het kan lezen, en start daarna de stack:

Terminal, in /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

De eerste start voert de migraties van de database uit; op onze test-VPS meldde de applicatie zich in minder dan tien seconden gezond. Om te controleren of ze antwoordt:

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

De eerste opdracht antwoordt 200. De tweede antwoordt "data":false zolang er geen account bestaat, en true zodra de Superadmin is aangemaakt.

Het eerste account, de rollen en de uitnodigingen

Checkmate heeft geen standaardaccount. De eerste persoon die zich registreert, wordt Superadmin; maak het uwe dus direct na de eerste start aan, voordat u het adres voor het publiek openstelt. Een SSH-tunnel brengt poort 52345 van de server naar uw computer, op http://localhost:52345; voeg -p toe met de SSH-poort die in uw klantenzone staat.

Terminal, op uw computer
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Open http://localhost:52345: Checkmate toont zijn registratiepagina.
  2. Vul uw voornaam, achternaam, e-mailadres en een wachtwoord van minstens 8 tekens in, met een hoofdletter, een kleine letter, een cijfer en een speciaal teken.
  3. Registreer u: u komt op het dashboard terecht, aangemeld als Superadmin.

Vanaf dan is de openbare registratie gesloten: op onze test-VPS werd elke nieuwe bezoeker naar de aanmeldpagina gestuurd, en ook het registratieadres leidde daarheen. Andere mensen komen binnen via een uitnodiging, vanuit de sectie Team van de accountinstellingen, met de rol User of Admin. De uitnodiging vertrekt per e-mail, en heeft dus de SMTP-instellingen hieronder nodig; de link ervan verloopt na één uur.

RolWat hij kan doen
UserAlle monitors, het dashboard, de controles, de incidenten, de statuspagina’s en de instellingen bekijken, zonder iets te wijzigen
AdminAlles wat een User kan, plus de monitors, de meldingskanalen, de incidenten, de onderhoudsvensters, de statuspagina’s, de uitnodigingen en de algemene instellingen, SMTP inbegrepen
SuperadminAlles wat een Admin kan, plus rechtstreeks accounts aanmaken, een andere gebruiker bewerken, een rol of een wachtwoord wijzigen

Sinds v4.0.0 zijn tags, statuspagina’s en proxy’s handelingen van een Admin: een User die ze vroeger kon beheren, verliest die toegang na de update.

HTTPS: de reverse proxy

De container serveert Checkmate via HTTP, op poort 52345. HTTPS komt voor rekening van een reverse proxy die ervoor staat: de documentatie noemt Caddy, Traefik en nginx. Wij hebben Caddy getest, geïnstalleerd vanuit zijn officiële repository voor Debian en Ubuntu: het haalt het certificaat van Let’s Encrypt zelf op, vernieuwt het, en geeft standaard de header Host en de headers X-Forwarded-* door.

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

Uw eerste monitor en zijn meldingen

  1. Klik in “Uptime” op “Create monitor” en kies HTTP/HTTPS.
  2. Vul het te controleren adres in, een naam die u in een melding herkent, en een interval: de documentatie raadt één tot vijf minuten aan voor een kritieke dienst.
  3. Sla op: Checkmate voert de eerste controle meteen uit. Op onze test-VPS stond de monitor een minuut later op up.

E-mail: de SMTP-instellingen

Meldingen per e-mail en uitnodigingen verlopen via een SMTP-verbinding voor de hele server, ingesteld onder “Settings”, tabblad “Email”: host, poort, gebruiker, wachtwoord en afzenderadres, daarna “Save” en “Test”. Gebruik op een VPS van Simafri een geauthenticeerde SMTP-server op poort 587 of 465: de e-maildienst van uw domein, of een verzenddienst. Maak daarna een e-mailmelding aan met de te waarschuwen adressen, en koppel haar aan uw monitors.

Slack, Discord, Teams, Telegram en de andere kanalen maakt u op dezelfde manier aan, onder “Notifications”, elk met zijn webhookadres of token, en elk met een knop “Test”.

Heartbeat-monitors voor uw geplande taken

Een heartbeat-monitor bewaakt een taak die vanzelf draait, zoals een nachtelijke back-up. Maak de ping-sleutel van het team aan onder “Settings”, tabblad “Monitoring” (hij wordt maar één keer getoond), maak een Heartbeat-monitor aan met een slug en een alarmvenster, en roep daarna zijn ping-URL aan aan het einde van de taak:

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"

Door /fail, of de exitcode van de taak, aan de URL toe te voegen, staat de monitor meteen op down, zonder te wachten tot het venster verstreken is.

Statuspagina’s

Onder “Status pages” publiceert een Admin een pagina met gekozen monitors en hun uptime, voor uw klanten of uw team. Sinds v4.0.0 heeft elke statuspagina een tijdzone, standaard UTC.

De back-ups

Alles staat op twee plaatsen: de MongoDB-database, in het volume mongo-data, en uw bestand .env. Bewaar dat laatste veilig: ENCRYPTION_KEY is nodig om de geheimen in de database te lezen, en JWT_SECRET houdt uw gebruikers aangemeld. De image van MongoDB bevat mongodump:

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

Plan deze kopie in en stuur haar buiten de server; een heartbeat-monitor kan u waarschuwen als ze ooit niet meer loopt. Op de schijf opgeslagen, gaan de archieven ook mee in de nachtelijke back-ups van de server.

Terugzetten

Stop op dezelfde of een nieuwe installatie, met dezelfde .env, de applicatie, laad het archief, en start haar daarna opnieuw:

Terminal, in /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

We hebben de hele cyclus op onze VPS getest: back-up, de database echt verwijderd, terugzetten. De monitor en het account kwamen terug, en aanmelden werkte meteen weer.

Checkmate v4.0.0 biedt ook versleutelde back-ups in de cloud via Checkmate Connect, een optionele dienst, gratis tijdens de bèta, die ENCRYPTION_KEY nodig heeft en een Superadmin om de installatie aan te melden. De kopieën hierboven werken zonder.

De updates

Lees de release notes, maak een back-up, wijzig de tag van de image in de compose.yaml, en haal daarna de nieuwe image op en maak de container opnieuw aan. De migraties van de database lopen vanzelf bij het opstarten:

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

Telemetrie

Checkmate stuurt één anoniem rapport per dag: een installatie-ID, de versie, de manier van installeren en het aantal monitors van elk type, nooit uw URL’s of resultaten. Het meldt dat in zijn logboek bij het opstarten. Om het uit te schakelen, voegt u TELEMETRY_ENABLED=false toe aan de omgeving van de dienst checkmate, en voert u daarna docker compose up -d uit.

Wie doet wat op een managed VPS

Self-hosting vraagt dat u naast de applicatie ook de server beheert. Op een managed VPS neemt ons team de server voor zijn rekening en houdt het uw instantie proactief in de gaten; Checkmate blijft uw software, met zijn monitors en uw instellingen.

OnderwerpOns teamU
De serverSysteem- en beveiligingsupdates, ingrepen op de server inbegrepenHet moment dat bij uw activiteit past
De monitoringServer 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachtenUw eigen monitors, meldingen en statuspagina’s in Checkmate
CheckmateProactief toezicht: fouten, vertragingen, database en schijfruimte opgespoord, correctie aangeradenDe installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent
De gebruikers en meldingenDe server die ze draagt, bewaakt en geback-uptDe accounts, de rollen, de uitnodigingen en de meldingskanalen
De back-upsElke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepenDe eigen database-exports van Checkmate, en het verzoek om terug te zetten, wanneer u dat nodig hebt
De migratieUw huidige server gemigreerd, gratisHet moment van de overschakeling

Wilt u liever dat ons team in de applicatie zelf ingrijpt, dan wordt die dienstverlening per uur of tegen een vast bedrag gefactureerd, met een offerte voordat het werk begint.

Checkmate, op een server die voor u wordt beheerd

Met een Managed VPS van Simafri houdt ons team de server van uw Checkmate-instantie up-to-date, bewaakt hem dag en nacht en grijpt in zonder op uw oproep te wachten; het houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast, zelf of via uw AI-assistent. De back-ups worden elke nacht versleuteld en buiten de machine bewaard, het terugzetten is inbegrepen, en de migratie van uw huidige server is gratis.

Ontdek Managed VPS

Veelgestelde vragen

Is Checkmate gratis?

Ja. Checkmate valt onder de AGPL-3.0-licentie: u kunt het draaien voor uzelf, uw team of uw klanten zonder een licentie te kopen. Als u het wijzigt en anderen het via het netwerk laat gebruiken, deelt u uw wijzigingen. Wat overblijft, zijn de kosten van de server waarop het draait.

Hoe installeer ik Checkmate met Docker Compose?

Gebruik de referentie-compose.yaml: de image ghcr.io/bluewave-labs/checkmate en MongoDB 8.0. Zet JWT_SECRET en ENCRYPTION_KEY in een bestand .env, stel CLIENT_HOST in op uw https-adres en NODE_ENV op production, publiceer poort 52345 op 127.0.0.1, start docker compose up -d en zet er een reverse proxy met HTTPS voor.

Wat zijn de standaard inloggegevens van Checkmate?

Die zijn er niet. De eerste persoon die zich op een nieuwe instantie registreert, wordt Superadmin. Maak uw account aan direct na de eerste start, via een SSH-tunnel; daarna worden bezoekers naar de aanmeldpagina gestuurd en komen nieuwe gebruikers binnen via een uitnodiging.

Hoeveel geheugen heeft Checkmate nodig?

De documentatie vraagt een Linux-VPS met 1 GB RAM of meer. Op onze test-VPS gebruikte een verse installatie ongeveer 300 MB voor Checkmate en 280 MB voor MongoDB. De schijf groeit mee met het aantal monitors, hun interval en de geschiedenis die u bewaart, standaard 90 dagen.

Hoe verstuur ik meldingen van Checkmate per e-mail?

Stel de SMTP-verbinding in onder Settings, tabblad Email: host, poort 587 of 465, gebruiker, wachtwoord en afzender, daarna Save en Test. Maak een e-mailmelding aan met de te waarschuwen adressen en koppel haar aan uw monitors. De uitnodigingen gebruiken dezelfde instellingen.

Hoe maak ik een back-up van Checkmate?

Exporteer de MongoDB-database met docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db, en bewaar een kopie van uw bestand .env, waarvan de ENCRYPTION_KEY nodig is om de opgeslagen geheimen te lezen. Zet terug met mongorestore --archive --gzip --drop, terwijl de applicatie gestopt is.

Hoe werk ik Checkmate bij?

Lees de release notes en maak een back-up, wijzig de tag van de image in compose.yaml, en voer daarna docker compose pull en docker compose up -d uit. De migraties van de database lopen vanzelf bij het opstarten.

Dekt een managed VPS ook Checkmate?

Een managed VPS dekt de server: systeem, beveiliging, monitoring en back-ups. Ons team houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast. Een ingreep in de applicatie wordt per uur of tegen een vast bedrag gefactureerd.

Bronnen en officiële documentatie

Neem contact op