Checkmate op engem Managed VPS hosten heescht, d’Iwwerwaachung vun Äre Websäiten an Äre Serveren op enger Maschinn ze halen, déi Iech gehéiert a vun eisen Equippen Dag an Nuecht aktuell gehal a verfollegt gëtt. Checkmate ass eng fräi Open-Source-Applikatioun fir d’Iwwerwaachung, ënner der AGPL-3.0-Lizenz: Disponibilitéit, Äntwertzäiten, Incidenter, Alarmer a Statussäiten. Dëse Guide follegt sengem offiziellen Docker-Image an der Versioun v4.0.0, a mir hunn all Befeel op engem VPS vu Simafri ausgeféiert, ier mir en geschriwwen hunn: d’Installatioun mat Docker Compose, HTTPS, den éischte Kont, d’Monitoren an d’Alarmer, d’Backups an d’Aktualiséierungen.
Auteur: Simon Vasconcelos Lee
Publizéiert de 17. November 2026Lieszäit: 12 Minutten
ghcr.io/bluewave-labs/checkmate a MongoDB 8.0, mam Port op 127.0.0.1 publizéiert, hannert engem HTTPS-Reverse-Proxy.JWT_SECRET, ENCRYPTION_KEY an Är ëffentlech Adress an CLIENT_HOST, a setzt NODE_ENV=production derbäi, dat am Referenzfichier feelt.mongodump a behaalt Äre Fichier .env, an aktualiséiert dann, andeems Dir den Tag vum Image ännert: d’Migratioune lafen eleng beim Start.Checkmate kontrolléiert Är Déngschter a reegelméissegen Ofstänn, notéiert all Äntwert an hir Äntwertzäit, a warnt Iech, wann eppes net méi äntwert. Säin Entwéckler, BlueWave Labs, beschreift et als selwer gehoste Tool, fir d’Hardware vun de Serveren, d’Disponibilitéit, d’Äntwertzäiten an d’Incidenter an Echtzäit ze verfollegen.
Checkmate gëtt ënner der GNU Affero General Public License, Versioun 3 (AGPL-3.0) publizéiert. Dir kënnt et gratis notzen, fir Iech, Är Entreprise oder Är Clienten, et kopéieren an et änneren.
Hir besonnesch Klausel betrëfft d’Notzung iwwer d’Netzwierk: wann Dir Checkmate ännert an aner Leit Är geännert Versioun iwwer d’Netzwierk benotze loosst, musst Dir hinnen hire Quellcode ubidden. Dat offiziellt Image onverännert ze bedreiwen, wéi an dësem Guide, bréngt keng sou eng Obligatioun mat sech. D’Software gëtt ouni Garantie zur Verfügung gestallt.
D’Dokumentatioun setzt eng bescheide Basis: all Linux-VPS mat 1 GB RAM oder méi. Si setzt derbäi, datt MongoDB ongeféier 400 MB op enger Instanz benotzt, déi all Minutt méi wéi 300 Serveren kontrolléiert.
D’Gréisst vum Server hänkt also vun der Zuel vun de Monitoren, hirem Intervall an dem Historique of, deen Dir behaalt. Op engem Managed VPS beschreift Dir eis Är Notzung, a mir recommandéieren Iech déi passend Gréisst.
Zënter der Versioun 3.10 kënnt Checkmate als eenzegt Image, ghcr.io/bluewave-labs/checkmate, dat souwuel d’Interface wéi och d’API servéiert. MongoDB leeft dernieft, a sengem eegene Container. Leet op engem Server mat Docker Engine a sengem Compose-Plugin, aus dem Repository vun Docker fir Ubuntu installéiert, en Dossier wéi /opt/checkmate un a setzt dës compose.yaml dran, déi op dem Referenzfichier vum Projet opbaut:
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:
Déi zwee Geheimnisser kommen an e Fichier .env dernieft, deen Docker Compose eleng liest. Leet en esou un, datt nëmme root en liese kann, a start dann 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 publizéiert: de Referenzfichier publizéiert en ouni Adress, an Docker mécht en dann op allen Adresse vum Server op. Lokal publizéiert, ass en nëmmen iwwer de Reverse Proxy z’erreechen.CLIENT_HOST ass d’Adress, déi Är Benotzer aginn, mat https://. Checkmate benotzt se fir d’Cross-Origin-Kontrollen a fir d’Linken a sengen Alarmer an E-Mailen.NODE_ENV=production: de README freet dono bei echten Deployementer. Ouni dat leeft d’Applikatioun am Entwécklungsmodus, deen d’Limitatioun vun den Ufroen op der API ausschalt.ENCRYPTION_KEY ass am Referenzfichier optional. E verschlësselt d’Geheimnisser, déi Checkmate späichert, an d’v4.0.0 verlaangt en fir d’TLS-Docker-Monitoren a fir Checkmate Connect. Setzt en vun Ufank un: dat ass méi einfach, wéi en duerno nozesetzen.latest an zitt et bei all Start. Mat enger kompletter Versiounsnummer, hei v4.0.0, decidéiert Dir selwer, wéini all Aktualiséierung kënnt.mongo-data hält all Är Donnéeën: Monitoren, Kontrollen, Benotzer an Astellungen.Den éischte Start féiert d’Migratioune vun der Datebank aus; op eisem Test-VPS huet d’Applikatioun sech an ënner zéng Sekonne gesond gemellt. Fir ze kontrolléieren, ob se äntwert:
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 éischte Befeel äntwert 200. Deen zweeten äntwert "data":false, soulaang kee Kont existéiert, an true, soubal de Superadmin ugeluecht ass.
Checkmate huet kee Standardkont. Déi éischt Persoun, déi sech umellt, gëtt Superadmin, leet Äre Kont also direkt nom éischte Start un, ier Dir d’Adress fir de Public opmaacht. En SSH-Tunnel bréngt de Port 52345 vum Server op Äre Computer, op http://localhost:52345; setzt -p an de SSH-Port derbäi, deen an Ärem Clientsberäich ugewise gëtt.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345 op: Checkmate weist seng Umeldungssäit.Vun do un ass d’ëffentlech Umeldung zou: op eisem Test-VPS gouf all neie Besucher op d’Loginsäit geschéckt, an d’Umeldungsadress huet och do higefouert. Aner Leit kommen op Invitatioun derbäi, vun der Rubrik Team an den Astellunge vum Kont aus, mat der Roll User oder Admin. D’Invitatioun gëtt per E-Mail verschéckt, brauch also d’SMTP-Astellunge méi ënnen, an hire Link leeft no enger Stonn of.
| Roll | Wat se maache kann |
|---|---|
| User | All Monitor, den Dashboard, d’Kontrollen, d’Incidenter, d’Statussäiten an d’Astellunge gesinn, ouni eppes z’änneren |
| Admin | Alles, wat en User kann, plus Monitoren, Notifikatiounskanäl, Incidenter, Wartungsfënsteren, Statussäiten, Invitatiounen a global Astellungen, SMTP abegraff |
| Superadmin | Alles, wat en Admin kann, plus Konten direkt uleeën, en anere Benotzer änneren, eng Roll oder e Passwuert änneren |
Zënter der v4.0.0 sinn Tags, Statussäiten a Proxyen Admin-Aktiounen: en User, deen se virdru verwalte konnt, verléiert deen Zougang no der Aktualiséierung.
De Container servéiert Checkmate iwwer HTTP, um Port 52345. HTTPS iwwerhëlt e Reverse Proxy, deen dervirsteet: d’Dokumentatioun nennt Caddy, Traefik an nginx. Mir hunn Caddy getest, aus sengem offiziellen Repository fir Debian an Ubuntu installéiert: et kritt d’Zertifikat vu Let’s Encrypt selwer, erneiert et a gëtt standardméisseg den Header Host an d’Headeren X-Forwarded-* weider.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST muss déi selwecht https://-Adress wéi de Proxy enthalen. Féiert no enger Ännerung docker compose up -d aus, fir de Container nei ze maachen.D’Alarmer per E-Mail an d’Invitatioune ginn iwwer eng SMTP-Verbindung fir de ganze Server, déi ënner „Settings“, Reiter „Email“, agestallt gëtt: Host, Port, Benotzer, Passwuert an Ofsenderadress, dann „Save“ an „Test“. Benotzt op engem VPS vu Simafri en authentifizéierte SMTP-Server, um Port 587 oder 465: den E-Mail-Déngscht vun Ärer Domain oder en Versanddéngscht. Leet dann eng E-Mail-Notifikatioun mat den Adressen un, déi gewarnt solle ginn, a verbannt se mat Äre Monitoren.
Slack, Discord, Teams, Telegram an déi aner Kanäl ginn op déi selwecht Manéier ugeluecht, ënner „Notifications“, jidderee mat senger Webhook-Adress oder sengem Token, a jidderee mat engem Knäppchen „Test“.
En Heartbeat-Monitor iwwerwaacht eng Aufgab, déi eleng leeft, wéi eng nuetlech Backup. Generéiert de Ping-Schlëssel vun der Equipe ënner „Settings“, Reiter „Monitoring“ (en gëtt nëmmen eemol ugewisen), leet en Heartbeat-Monitor mat engem Slug an enger Alarmfënster un, a rifft dann seng Ping-URL um Enn vun der Aufgab op:
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 "https://status.example.com/api/v1/heartbeat/<ping-key>/nightly-backup"
Wann Dir /fail oder den Exitcode vun der Aufgab un d’URL uhänkt, gëtt de Monitor direkt als „down“ markéiert, ouni datt d’Fënster muss oflafen.
Ënner „Status pages“ publizéiert en Admin eng Säit, déi ausgewielte Monitoren an hir Disponibilitéit opzielt, fir Är Clienten oder Är Equipe. Zënter der v4.0.0 huet all Statussäit eng Zäitzon, standardméisseg UTC.
Alles läit op zwou Plazen: an der MongoDB-Datebank, am Volume mongo-data, an an Ärem Fichier .env. Haalt dee leschte sécher: ENCRYPTION_KEY ass néideg, fir d’Geheimnisser ze liesen, déi an der Datebank gespäichert sinn, an JWT_SECRET hält Är Benotzer ageloggt. D’MongoDB-Image enthält mongodump:
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak
Plangt dës Kopie an a schéckt se baussent de Server; en Heartbeat-Monitor kann Iech soen, wann se emol net méi leeft. Um Disk geluecht, kommen d’Archiven och an d’Backups vum Server vun der Nuecht.
Op der selwechter oder enger neier Installatioun, mat der selwechter .env, stoppt Dir d’Applikatioun, luet d’Archiv an a start se dann nees:
docker compose stop checkmate
docker compose exec -T mongodb mongorestore --archive --gzip --drop < checkmate-2026-11-17.archive.gz
docker compose start checkmate
Mir hunn de ganze Zyklus op eisem VPS getest: Backup, d’Datebank wierklech geläscht, Restauratioun. De Monitor an de Kont sinn erëmkomm, an d’Umeldung huet direkt nees funktionéiert.
Checkmate v4.0.0 bitt och verschlësselt Backups an der Cloud iwwer Checkmate Connect un, en optionalen Déngscht, gratis während senger Beta-Phas, deen ENCRYPTION_KEY an e Superadmin brauch, fir d’Installatioun anzeschreiwen. D’Kopien uewe funktionéieren ouni en.
Liest d’Release Notes, maacht eng Backup, ännert den Tag vum Image an der compose.yaml, luet dann dat neit Image erof a maacht de Container nei. D’Migratioune vun der Datebank lafen eleng beim Start:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump a mongorestore mat. Keng nei Ëmfeldvariabel ass néideg.checkmate-client, checkmate-backend a checkmate-mongo bedreiwen, déi net méi aktualiséiert ginn. Wiesselt op ghcr.io/bluewave-labs/checkmate a behaalt Äre MongoDB-Service a säi Volume; d’Variabelen UPTIME_APP_* ginn net méi gelies.Checkmate schéckt een anonyme Bericht pro Dag: eng Installatiouns-ID, d’Versioun, d’Aart vun der Installatioun an d’Zuel vun de Monitoren vun all Typ, ni Är URLen oder Resultater. Et seet dat a sengem Logbuch beim Start. Fir se auszeschalten, setzt TELEMETRY_ENABLED=false an d’Ëmfeld vum Service checkmate, a féiert dann docker compose up -d aus.
Selwer hosten heescht, de Server zousätzlech zur Applikatioun ze halen. Op engem Managed VPS huelen eis Equippen de Server an d’Hand a verfollegen Är Instanz proaktiv; Checkmate bleift Är Software, mat senge Monitoren an Ären Astellungen.
| Thema | Eis Equippen | Dir |
|---|---|---|
| De Server | System- a Sécherheetsupdates, Interventioune um Server abegraff | De Moment, deen zu Ärer Aktivitéit passt |
| D’Iwwerwaachung | Server 24 Stonnen op 24 a 7 Deeg op 7 verfollegt, mat Interventioun, ouni op Ären Uruff ze waarden | Är eege Monitoren, Alarmer a Statussäiten an Checkmate |
| Checkmate | Proaktiv Suivi: Feeler, lues Äntwertzäiten, Datebank a Späicherplaz erkannt, Korrektur recommandéiert | Seng Installatioun, seng Aktualiséierungen a seng Astellungen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent |
| D’Benotzer an d’Alarmer | De Server, deen se dréit, iwwerwaacht a gesécheert | D’Konten, d’Rollen, d’Invitatiounen an d’Notifikatiounskanäl |
| D’Backups | All Nuecht, verschlësselt a baussent der Maschinn gelagert; Restauratioun abegraff | D’Exporter vun der Datebank, déi Checkmate eegen sinn, an d’Ufro fir eng Restauratioun, wann Dir se braucht |
| D’Migratioun | Äre bestoende Server migréiert, offréiert | De Moment vum Wiessel |
Wann Dir léiwer wëllt, datt eis Equippen an der Applikatioun selwer intervenéieren, gëtt dës Prestatioun op Stonnebasis oder pauschal verrechent, mat engem Käschtevirschlag, deen Iech virun der Interventioun matgedeelt gëtt.
Mat engem Managed VPS vu Simafri halen eis Equippen de Server vun Ärer Checkmate-Instanz aktuell, iwwerwaachen en Dag an Nuecht a gräifen an, ouni op Ären Uruff ze waarden; si verfollegen och Är Instanz proaktiv a recommandéieren Iech déi nëtzlech Korrekturen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent. D’Backups ginn all Nuecht verschlësselt a baussent der Maschinn gelagert, hir Restauratioun ass abegraff, an d’Migratioun vun Ärem aktuelle Server ass offréiert.
Jo. Checkmate steet ënner der AGPL-3.0-Lizenz: Dir kënnt et fir Iech, Är Equipe oder Är Clienten bedreiwen, ouni eng Lizenz ze kafen. Wann Dir et ännert an anerer et iwwer d’Netzwierk benotze loosst, deelt Dir Är Ännerungen. Et bleiwen d’Käschte vum Server, op deem et leeft.
Benotzt d’Referenz-compose.yaml: d’Image ghcr.io/bluewave-labs/checkmate a MongoDB 8.0. Setzt JWT_SECRET an ENCRYPTION_KEY an e Fichier .env, setzt CLIENT_HOST op Är https-Adress an NODE_ENV op production, publizéiert de Port 52345 op 127.0.0.1, start docker compose up -d a setzt en HTTPS-Reverse-Proxy dervir.
Et gëtt keen. Déi éischt Persoun, déi sech op enger neier Instanz umellt, gëtt Superadmin. Leet Äre Kont direkt nom éischte Start un, iwwer en SSH-Tunnel; duerno ginn d’Besucher op d’Loginsäit geschéckt, an nei Benotzer kommen op Invitatioun derbäi.
D’Dokumentatioun freet no engem Linux-VPS mat 1 GB RAM oder méi. Op eisem Test-VPS huet eng frësch Installatioun ongeféier 300 MB fir Checkmate an 280 MB fir MongoDB benotzt. Den Disk wiisst mat der Zuel vun de Monitoren, hirem Intervall an dem Historique, deen Dir behaalt, standardméisseg 90 Deeg.
Stellt d’SMTP-Verbindung ënner Settings, Reiter Email, an: Host, Port 587 oder 465, Benotzer, Passwuert an Ofsender, dann Save an Test. Leet eng E-Mail-Notifikatioun mat den Adressen un, déi gewarnt solle ginn, a verbannt se mat Äre Monitoren. D’Invitatioune benotzen déi selwecht Astellungen.
Exportéiert d’MongoDB-Datebank mat docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db, a behaalt eng Kopie vun Ärem Fichier .env, deem säin ENCRYPTION_KEY néideg ass, fir déi gespäichert Geheimnisser ze liesen. Restauréiert mat mongorestore --archive --gzip --drop, bei gestoppter Applikatioun.
Liest d’Release Notes a maacht eng Backup, ännert den Tag vum Image an der compose.yaml, a féiert dann docker compose pull an docker compose up -d aus. D’Migratioune vun der Datebank lafen eleng beim Start.
E Managed VPS deckt de Server of: System, Sécherheet, Iwwerwaachung a Backups. Eis Equippen verfollegen och Är Instanz proaktiv a recommandéieren Iech déi nëtzlech Korrekturen, déi Dir ëmsetzt. Eng Interventioun an der Applikatioun gëtt op Stonnebasis oder pauschal verrechent.
Simafri
Loosst eis iwwer Är Websäit schwätzen
Erzielt eis vun Ärem Projet a wéinege Wierder: mir mellen eis séier bei Iech.
Merci! Är Ufro gouf geschéckt. Mir mellen eis séier bei Iech.
Léiwer per E-Mail? Schreift eis op support@simafri.com.