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.
Door Simon Vasconcelos Lee
Gepubliceerd op 17 november 2026Leestijd: 12 minuten
ghcr.io/bluewave-labs/checkmate en MongoDB 8.0, met de poort gepubliceerd op 127.0.0.1 achter een reverse proxy met HTTPS.JWT_SECRET, ENCRYPTION_KEY en uw openbare adres in CLIENT_HOST in, en voeg NODE_ENV=production toe, dat het referentiebestand weglaat.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.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.
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 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.
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:
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:
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: het referentiebestand publiceert hem zonder adres, en Docker opent hem dan op alle adressen van de server. Lokaal gepubliceerd is hij alleen bereikbaar via de reverse proxy.CLIENT_HOST is het adres dat uw gebruikers intypen, met https://. Checkmate gebruikt het voor de cross-origincontroles en voor de links in zijn meldingen en e-mails.NODE_ENV=production: de README vraagt erom bij echte implementaties. Zonder deze variabele draait de applicatie in ontwikkelmodus, wat de rate limiter van de API uitschakelt.ENCRYPTION_KEY is optioneel in het referentiebestand. Ze versleutelt de geheimen die Checkmate opslaat, en v4.0.0 vereist haar voor Docker-monitors met TLS en voor Checkmate Connect. Stel haar vanaf het begin in: dat is eenvoudiger dan haar later toe te voegen.latest en haalt die bij elke start op. Met een volledige versie, hier v4.0.0, kiest u zelf wanneer elke update gebeurt.mongo-data bevat al uw gegevens: monitors, controles, gebruikers en instellingen.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:
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.
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.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate toont zijn registratiepagina.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.
| Rol | Wat hij kan doen |
|---|---|
| User | Alle monitors, het dashboard, de controles, de incidenten, de statuspagina’s en de instellingen bekijken, zonder iets te wijzigen |
| Admin | Alles wat een User kan, plus de monitors, de meldingskanalen, de incidenten, de onderhoudsvensters, de statuspagina’s, de uitnodigingen en de algemene instellingen, SMTP inbegrepen |
| Superadmin | Alles 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.
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.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST moet hetzelfde adres met https:// bevatten als de proxy. Voer na een wijziging docker compose up -d uit om de container opnieuw aan te maken.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”.
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:
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.
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.
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:
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.
Stop op dezelfde of een nieuwe installatie, met dezelfde .env, de applicatie, laad het archief, en start haar daarna opnieuw:
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.
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:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump en mongorestore. Er is geen nieuwe omgevingsvariabele vereist.checkmate-client, checkmate-backend en checkmate-mongo, die niet meer worden bijgewerkt. Stap over op ghcr.io/bluewave-labs/checkmate en behoud uw MongoDB-dienst en zijn volume; de variabelen UPTIME_APP_* worden niet meer ingelezen.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.
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.
| Onderwerp | Ons team | U |
|---|---|---|
| De server | Systeem- en beveiligingsupdates, ingrepen op de server inbegrepen | Het moment dat bij uw activiteit past |
| De monitoring | Server 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachten | Uw eigen monitors, meldingen en statuspagina’s in Checkmate |
| Checkmate | Proactief toezicht: fouten, vertragingen, database en schijfruimte opgespoord, correctie aangeraden | De installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent |
| De gebruikers en meldingen | De server die ze draagt, bewaakt en geback-upt | De accounts, de rollen, de uitnodigingen en de meldingskanalen |
| De back-ups | Elke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepen | De eigen database-exports van Checkmate, en het verzoek om terug te zetten, wanneer u dat nodig hebt |
| De migratie | Uw huidige server gemigreerd, gratis | Het 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Laten we het over uw website hebben
Vertel ons in een paar woorden over uw project: wij nemen snel contact met u op.
Bedankt! Uw aanvraag is verzonden. We nemen spoedig contact met u op.
Liever per e-mail? Schrijf ons op support@simafri.com.