Checkmate op engem Managed VPS hosten: Iwwerwaachung op Ärem eegene Server

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.

Simon Vasconcelos Lee Auteur: Publizéiert de 17. November 2026Lieszäit: 12 Minutten

All Guiden

Dat Wesentlecht

  1. D’AGPL-3.0-Lizenz erlaabt et, Checkmate fir Iech, Är Equipe oder Är Clienten ze bedreiwen, ouni eng Lizenz ze kafen; wann Dir et ännert an anerer et iwwer d’Netzwierk benotze loosst, deelt Dir Är Ännerungen.
  2. Installéiert et mat Docker Compose: dat All-in-One-Image ghcr.io/bluewave-labs/checkmate a MongoDB 8.0, mam Port op 127.0.0.1 publizéiert, hannert engem HTTPS-Reverse-Proxy.
  3. Setzt JWT_SECRET, ENCRYPTION_KEY an Är ëffentlech Adress an CLIENT_HOST, a setzt NODE_ENV=production derbäi, dat am Referenzfichier feelt.
  4. Déi éischt Persoun, déi sech umellt, gëtt Superadmin: leet Äre Kont direkt nom éischte Start un, duerno kommen all déi aner op Invitatioun derbäi.
  5. Séchert d’MongoDB-Datebank mat mongodump a behaalt Äre Fichier .env, an aktualiséiert dann, andeems Dir den Tag vum Image ännert: d’Migratioune lafen eleng beim Start.

Wat Checkmate mécht

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.

Wat d’AGPL-3.0-Lizenz erlaabt

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’Ressourcen, mat deenen Dir rechent

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.

D’Installatioun mat Docker Compose

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:

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:

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:

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

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:

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

Den éischte Befeel äntwert 200. Deen zweeten äntwert "data":false, soulaang kee Kont existéiert, an true, soubal de Superadmin ugeluecht ass.

Den éischte Kont, d’Rollen an d’Invitatiounen

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.

Terminal, op Ärem Computer
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Maacht http://localhost:52345 op: Checkmate weist seng Umeldungssäit.
  2. Gitt Äre Virnumm, Äre Familljennumm, Är E-Mail-Adress an e Passwuert mat op d’mannst 8 Zeechen an, mat engem Groussbuschtaf, engem Klengbuschtaf, enger Zuel an engem Sonnerzeechen.
  3. Mellt Iech un: Dir landt um Dashboard, als Superadmin ageloggt.

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.

RollWat se maache kann
UserAll Monitor, den Dashboard, d’Kontrollen, d’Incidenter, d’Statussäiten an d’Astellunge gesinn, ouni eppes z’änneren
AdminAlles, wat en User kann, plus Monitoren, Notifikatiounskanäl, Incidenter, Wartungsfënsteren, Statussäiten, Invitatiounen a global Astellungen, SMTP abegraff
SuperadminAlles, 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.

HTTPS: de Reverse Proxy

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.

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

Ären éischte Monitor a seng Alarmer

  1. Klickt ënner „Uptime“ op „Create monitor“ a wielt HTTP/HTTPS.
  2. Gitt d’Adress an, déi kontrolléiert gi soll, en Numm, deen Dir an engem Alarm erkennt, an en Intervall: d’Dokumentatioun recommandéiert eng bis fënnef Minutte fir e kriteschen Déngscht.
  3. Späichert: Checkmate féiert déi éischt Kontroll direkt aus. Op eisem Test-VPS war de Monitor eng Minutt méi spéit am Status „up“.

D’E-Mail: d’SMTP-Astellungen

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

Heartbeat-Monitoren fir Är geplangten Aufgaben

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:

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"

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.

D’Statussäiten

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

D’Backups

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:

Terminal, an /opt/checkmate
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.

D’Restauratioun

Op der selwechter oder enger neier Installatioun, mat der selwechter .env, stoppt Dir d’Applikatioun, luet d’Archiv an a start se dann nees:

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

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.

D’Aktualiséierungen

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:

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

D’Telemetrie

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.

Wien mécht wat op engem Managed VPS

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.

ThemaEis EquippenDir
De ServerSystem- a Sécherheetsupdates, Interventioune um Server abegraffDe Moment, deen zu Ärer Aktivitéit passt
D’IwwerwaachungServer 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
CheckmateProaktiv Suivi: Feeler, lues Äntwertzäiten, Datebank a Späicherplaz erkannt, Korrektur recommandéiertSeng Installatioun, seng Aktualiséierungen a seng Astellungen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent
D’Benotzer an d’AlarmerDe Server, deen se dréit, iwwerwaacht a gesécheertD’Konten, d’Rollen, d’Invitatiounen an d’Notifikatiounskanäl
D’BackupsAll Nuecht, verschlësselt a baussent der Maschinn gelagert; Restauratioun abegraffD’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éiertDe 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.

Checkmate, op engem Server, dee fir Iech gefleegt 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.

Managed VPS entdecken

Dacks gestallte Froen

Ass Checkmate gratis?

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.

Wéi installéieren ech Checkmate mat Docker Compose?

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.

Wat ass de Standard-Login vu Checkmate?

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.

Wéi vill Aarbechtsspäicher brauch Checkmate?

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.

Wéi schécken ech Alarmer vu Checkmate per E-Mail?

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.

Wéi sécheren ech Checkmate?

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.

Wéi aktualiséieren ech Checkmate?

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.

Deckt e Managed VPS Checkmate of?

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.

Quellen an offiziell Dokumentatioun

Verbonne Guiden

Uptime Kuma op engem Managed VPS hosten: iwwerwaacht Är Servicer permanentUptime Kuma op engem Managed VPS hosten heescht, Är Websäiten, Är APIen an Är Server vun enger Maschinn aus ze iwwerwaachen, déi Iech gehéiert a vun eisen Equippe Dag an Nuecht aktuell gehal a verfollegt gëtt. Uptime Kuma ass eng fräi Software ënner der MIT-Lizenz. Dëse Guide follegt senger offizieller Dokumentatioun: d’Installatioun mat Docker Compose, HTTPS, d’Datebank, d’Notifikatiounen, d’Backups an d’Aktualiséierungen.Backups vun engem VPS: wat Dir kontrolléiere sollt, ier Dir ënnerschreiftEng VPS-Offer kënnegt bal ëmmer „Backups abegraff“ un. Hannert deenen zwee Wierder kann eng Kopie all Nuecht stoen, baussent der Maschinn gelagert a vun Experte restauréiert, oder e Snapshot um selwechten Disk wéi de Server. Dëse Guide gëtt d’Froen, déi den Ënnerscheed maachen, wat all Äntwert bedeit, a wéi Dir iwwerpréift, datt e Backup sech restauréiere léisst.Ënnerscheed tëscht Managed an Unmanaged VPS: wien wat méchtDen Ënnerscheed tëscht engem Managed an engem Unmanaged VPS hänkt un enger eenzeger Fro: wien sech ëm de Server këmmert, soubal e leeft. Dobäi huet „Managed“ keng offiziell Definitioun: vun engem Hostingubidder zum aneren geet d’Wuert vun enger einfacher Installatioun vum System bis zum komplette Betrib vum Server. Dëse Guide weist, wien wat mécht, Zeil fir Zeil, mam Zwëschenniveau vum Support, a gëtt d’Froen, déi d’Onkloerheet ophiewen, ier Dir ënnerschreift.
Kontaktéiert eis