Checkmate auf einem Managed VPS hosten: Verfügbarkeit im Blick, auf Ihrem Server

Checkmate auf einem Managed VPS zu hosten heißt, die Überwachung Ihrer Websites und Server auf einer Maschine zu behalten, die Ihnen gehört und die unsere Teams aktuell halten und Tag und Nacht beaufsichtigen. Checkmate ist eine freie, quelloffene Überwachungsanwendung unter der AGPL-3.0-Lizenz: Verfügbarkeit, Antwortzeiten, Vorfälle, Alarme und Statusseiten. Dieser Leitfaden folgt dem offiziellen Docker-Image in Version v4.0.0, und wir haben jeden Befehl vor dem Schreiben auf einem VPS von Simafri ausgeführt: die Installation mit Docker Compose, HTTPS, das erste Konto, Monitore und Alarme, Backups und Updates.

Simon Vasconcelos Lee Von Veröffentlicht am 17. November 2026Lesezeit: 12 Minuten

Alle Leitfäden

Das Wichtigste in Kürze

  1. Die AGPL-3.0-Lizenz erlaubt es, Checkmate für sich, Ihr Team oder Ihre Kunden zu betreiben, ohne eine Lizenz zu kaufen; wenn Sie es ändern und anderen über das Netzwerk zur Nutzung bereitstellen, teilen Sie Ihre Änderungen.
  2. Installieren Sie es mit Docker Compose: das All-in-one-Image ghcr.io/bluewave-labs/checkmate und MongoDB 8.0, mit dem Port auf 127.0.0.1 veröffentlicht, hinter einem Reverse Proxy mit HTTPS.
  3. Setzen Sie JWT_SECRET, ENCRYPTION_KEY und Ihre öffentliche Adresse in CLIENT_HOST, und ergänzen Sie NODE_ENV=production, das in der Referenzdatei fehlt.
  4. Die erste Person, die sich registriert, wird Superadmin: Legen Sie Ihr Konto gleich nach dem ersten Start an; alle anderen kommen danach per Einladung dazu.
  5. Sichern Sie die MongoDB-Datenbank mit mongodump und bewahren Sie Ihre Datei .env auf; aktualisieren Sie dann, indem Sie das Image-Tag ändern: Die Migrationen laufen beim Start von selbst.

Was Checkmate kann

Checkmate prüft Ihre Dienste in regelmäßigen Abständen, zeichnet jede Antwort und ihre Antwortzeit auf und alarmiert Sie, wenn etwas nicht mehr antwortet. Sein Entwickler, BlueWave Labs, beschreibt es als selbst gehostetes Werkzeug, um Server-Hardware, Verfügbarkeit, Antwortzeiten und Vorfälle in Echtzeit zu verfolgen.

Was die AGPL-3.0-Lizenz erlaubt

Checkmate wird unter der GNU Affero General Public License, Version 3 (AGPL-3.0) veröffentlicht. Sie können es kostenlos nutzen, für sich, Ihr Unternehmen oder Ihre Kunden, es kopieren und ändern.

Ihre besondere Klausel betrifft die Nutzung über das Netzwerk: Wenn Sie Checkmate ändern und anderen Personen Ihre geänderte Fassung über das Netzwerk zur Nutzung bereitstellen, müssen Sie ihnen deren Quellcode anbieten. Wer das offizielle Image unverändert betreibt, wie in diesem Leitfaden, hat keine solche Pflicht. Die Software wird ohne Gewährleistung bereitgestellt.

Die einzuplanenden Ressourcen

Die Dokumentation setzt eine bescheidene Untergrenze: jeder Linux-VPS mit 1 GB Arbeitsspeicher oder mehr. Sie fügt hinzu, dass MongoDB etwa 400 MB belegt, auf einer Instanz, die mehr als 300 Server jede Minute prüft.

Die Größe des Servers hängt also von der Zahl der Monitore, ihrem Intervall und dem Verlauf ab, den Sie aufbewahren. Auf einem Managed VPS beschreiben Sie uns Ihre Nutzung, und wir empfehlen Ihnen die passende Größe.

Die Installation mit Docker Compose

Seit Version 3.10 wird Checkmate als ein einziges Image ausgeliefert, ghcr.io/bluewave-labs/checkmate, das sowohl die Oberfläche als auch die API bereitstellt. MongoDB läuft daneben, in einem eigenen Container. Legen Sie auf einem Server mit Docker Engine und seinem Compose-Plugin, installiert aus dem Docker-Repository für Ubuntu, einen Ordner wie /opt/checkmate an und speichern Sie darin diese compose.yaml, die auf der Referenzdatei des Projekts aufbaut:

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:

Die beiden Geheimnisse kommen in eine Datei .env daneben, die Docker Compose von selbst liest. Legen Sie sie so an, dass nur root sie lesen kann, und starten Sie dann den 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

Der erste Start führt die Migrationen der Datenbank aus; auf unserem Test-VPS meldete sich die Anwendung in weniger als zehn Sekunden als betriebsbereit. Um zu prüfen, ob sie antwortet:

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

Der erste Befehl antwortet 200. Der zweite antwortet "data":false, solange kein Konto existiert, und true, sobald der Superadmin angelegt ist.

Das erste Konto, die Rollen und die Einladungen

Checkmate hat kein Standardkonto. Die erste Person, die sich registriert, wird Superadmin; legen Sie Ihr Konto also gleich nach dem ersten Start an, bevor Sie die Adresse öffentlich zugänglich machen. Ein SSH-Tunnel holt den Port 52345 des Servers auf Ihren Computer, unter http://localhost:52345; ergänzen Sie -p und den SSH-Port, der in Ihrem Kundenbereich angegeben ist.

Terminal, auf Ihrem Computer
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Öffnen Sie http://localhost:52345: Checkmate zeigt seine Registrierungsseite.
  2. Geben Sie Ihren Vornamen, Ihren Nachnamen, Ihre E-Mail-Adresse und ein Passwort mit mindestens 8 Zeichen ein, mit einem Großbuchstaben, einem Kleinbuchstaben, einer Ziffer und einem Sonderzeichen.
  3. Registrieren Sie sich: Sie landen auf dem Dashboard, als Superadmin angemeldet.

Ab dann ist die öffentliche Registrierung geschlossen: Auf unserem Test-VPS wurde jeder neue Besucher zur Anmeldeseite geleitet, und auch die Registrierungsadresse führte dorthin. Andere Personen kommen per Einladung dazu, aus dem Bereich Team der Kontoeinstellungen, mit der Rolle User oder Admin. Die Einladung geht per E-Mail hinaus, braucht also die SMTP-Einstellungen weiter unten, und ihr Link läuft nach einer Stunde ab.

RolleWas sie darf
UserAlle Monitore, das Dashboard, die Prüfungen, die Vorfälle, die Statusseiten und die Einstellungen sehen, ohne etwas zu ändern
AdminAlles, was ein User darf, dazu die Monitore, die Benachrichtigungskanäle, die Vorfälle, die Wartungsfenster, die Statusseiten, die Einladungen und die globalen Einstellungen, SMTP inbegriffen
SuperadminAlles, was ein Admin darf, dazu Konten direkt anlegen, einen anderen Nutzer bearbeiten, eine Rolle oder ein Passwort ändern

Seit v4.0.0 sind Tags, Statusseiten und Proxys Aktionen für Admins: Ein User, der sie vorher verwalten konnte, verliert diesen Zugriff nach dem Update.

HTTPS: der Reverse Proxy

Der Container liefert Checkmate über HTTP aus, auf Port 52345. HTTPS übernimmt ein vorgeschalteter Reverse Proxy: Die Dokumentation nennt Caddy, Traefik und nginx. Wir haben Caddy getestet, installiert aus seinem offiziellen Repository für Debian und Ubuntu: Es bezieht das Zertifikat von Let’s Encrypt selbst, erneuert es und leitet standardmäßig den Header Host und die Header X-Forwarded-* weiter.

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

Ihr erster Monitor und seine Alarme

  1. Klicken Sie unter „Uptime“ auf „Create monitor“ und wählen Sie HTTP/HTTPS.
  2. Geben Sie die zu prüfende Adresse ein, einen Namen, den Sie in einem Alarm wiedererkennen, und ein Intervall: Die Dokumentation empfiehlt eine bis fünf Minuten für einen kritischen Dienst.
  3. Speichern Sie: Checkmate führt die erste Prüfung sofort aus. Auf unserem Test-VPS war der Monitor eine Minute später auf „up“.

E-Mail: die SMTP-Einstellungen

Alarme per E-Mail und Einladungen laufen über eine SMTP-Verbindung für den ganzen Server, eingestellt unter „Settings“, Reiter „Email“: Host, Port, Benutzer, Passwort und Absenderadresse, dann „Save“ und „Test“. Verwenden Sie auf einem VPS von Simafri einen authentifizierten SMTP-Server auf Port 587 oder 465: den E-Mail-Dienst Ihrer Domain oder einen Versanddienst. Legen Sie danach eine E-Mail-Benachrichtigung mit den zu alarmierenden Adressen an und verknüpfen Sie sie mit Ihren Monitoren.

Slack, Discord, Teams, Telegram und die anderen Kanäle legen Sie genauso an, unter „Notifications“, jeweils mit ihrer Webhook-Adresse oder ihrem Token und jeweils mit einer Schaltfläche „Test“.

Heartbeat-Monitore für Ihre geplanten Aufgaben

Ein Heartbeat-Monitor überwacht eine Aufgabe, die von selbst läuft, etwa ein nächtliches Backup. Erzeugen Sie den Ping-Schlüssel des Teams unter „Settings“, Reiter „Monitoring“ (er wird nur einmal angezeigt), legen Sie einen Heartbeat-Monitor mit einem Slug und einem Alarmfenster an und rufen Sie dann am Ende der Aufgabe seine Ping-URL auf:

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"

Wenn Sie /fail oder den Exit-Code der Aufgabe an die URL anhängen, wird der Monitor sofort als ausgefallen markiert, ohne das Ende des Fensters abzuwarten.

Die Statusseiten

Unter „Status pages“ veröffentlicht ein Admin eine Seite, die ausgewählte Monitore und ihre Verfügbarkeit auflistet, für Ihre Kunden oder Ihr Team. Seit v4.0.0 hat jede Statusseite eine Zeitzone, standardmäßig UTC.

Die Backups

Alles liegt an zwei Stellen: in der MongoDB-Datenbank, im Volume mongo-data, und in Ihrer Datei .env. Bewahren Sie Letztere sicher auf: ENCRYPTION_KEY wird gebraucht, um die in der Datenbank gespeicherten Geheimnisse zu lesen, und JWT_SECRET hält Ihre Nutzer angemeldet. Das MongoDB-Image enthält 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

Planen Sie diese Kopie regelmäßig ein und senden Sie sie außerhalb des Servers; ein Heartbeat-Monitor kann Ihnen melden, wenn sie einmal nicht mehr läuft. Auf der Festplatte abgelegt, gehen die Archive außerdem in die nächtlichen Backups des Servers ein.

Die Wiederherstellung

Halten Sie auf derselben oder einer neuen Installation, mit derselben .env, die Anwendung an, spielen Sie das Archiv ein und starten Sie sie dann wieder:

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

Wir haben den ganzen Ablauf auf unserem VPS getestet: Backup, die Datenbank tatsächlich gelöscht, Wiederherstellung. Der Monitor und das Konto waren wieder da, und die Anmeldung funktionierte sofort wieder.

Checkmate v4.0.0 bietet außerdem verschlüsselte Cloud-Backups über Checkmate Connect an, einen optionalen Dienst, kostenlos während seiner Beta, der ENCRYPTION_KEY und einen Superadmin braucht, um die Installation anzumelden. Die Kopien oben funktionieren ohne ihn.

Die Updates

Lesen Sie die Release Notes, erstellen Sie ein Backup, ändern Sie das Image-Tag in der compose.yaml, laden Sie dann das neue Image und erstellen Sie den Container neu. Die Migrationen der Datenbank laufen beim Start von selbst:

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

Die Telemetrie

Checkmate sendet einen anonymen Bericht pro Tag: eine Installationskennung, die Version, die Art der Installation und die Zahl der Monitore jedes Typs, niemals Ihre URLs oder Ergebnisse. Es weist beim Start in seinem Protokoll darauf hin. Um sie abzuschalten, ergänzen Sie TELEMETRY_ENABLED=false in der Umgebung des Dienstes checkmate und führen Sie dann docker compose up -d aus.

Wer was tut auf einem Managed VPS

Beim Selbsthosting müssen Sie neben der Anwendung auch den Server betreuen. Auf einem Managed VPS übernehmen unsere Teams den Server und betreuen Ihre Instanz proaktiv; Checkmate bleibt Ihre Software, mit seinen Monitoren und Ihren Einstellungen.

ThemaUnsere TeamsSie
Der ServerSystem- und Sicherheitsupdates, Eingriffe am Server inbegriffenDer Zeitpunkt, der zu Ihrem Betrieb passt
Die ÜberwachungServer rund um die Uhr im Blick, mit Eingriff, ohne auf Ihren Anruf zu wartenIhre eigenen Monitore, Alarme und Statusseiten in Checkmate
CheckmateProaktive Betreuung: Fehler, lange Antwortzeiten, Datenbank und Speicherplatz erkannt, Korrektur empfohlenInstallation, Updates und Einstellungen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten
Die Nutzer und AlarmeDer Server, der sie trägt, überwacht und gesichertDie Konten, die Rollen, die Einladungen und die Benachrichtigungskanäle
Die BackupsJede Nacht, verschlüsselt und außerhalb der Maschine aufbewahrt; Wiederherstellung inbegriffenDie eigenen Datenbankexporte von Checkmate und die Wiederherstellungsanfrage, wenn Sie sie brauchen
Die MigrationIhr aktueller Server wird kostenlos migriertDer Zeitpunkt der Umstellung

Wenn unsere Teams lieber in der Anwendung selbst eingreifen sollen, wird diese Leistung nach Stunden oder pauschal abgerechnet, mit einem Kostenvoranschlag vor dem Eingriff.

Checkmate auf einem Server, der für Sie gepflegt wird

Mit einem Managed VPS von Simafri halten unsere Teams den Server Ihrer Checkmate-Instanz aktuell, überwachen ihn Tag und Nacht und greifen ein, ohne auf Ihren Anruf zu warten; sie betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten. Die Backups werden jede Nacht verschlüsselt und außerhalb der Maschine aufbewahrt, ihre Wiederherstellung ist inbegriffen, und die Migration Ihres aktuellen Servers ist kostenlos.

Managed VPS entdecken

Häufige Fragen

Ist Checkmate kostenlos?

Ja. Checkmate steht unter der AGPL-3.0-Lizenz: Sie können es für sich, Ihr Team oder Ihre Kunden betreiben, ohne eine Lizenz zu kaufen. Wenn Sie es ändern und anderen über das Netzwerk zur Nutzung bereitstellen, teilen Sie Ihre Änderungen. Bleiben die Kosten für den Server, auf dem es läuft.

Wie installiere ich Checkmate mit Docker Compose?

Verwenden Sie die Referenz-compose.yaml: das Image ghcr.io/bluewave-labs/checkmate und MongoDB 8.0. Legen Sie JWT_SECRET und ENCRYPTION_KEY in einer Datei .env ab, setzen Sie CLIENT_HOST auf Ihre https-Adresse und NODE_ENV auf production, veröffentlichen Sie den Port 52345 auf 127.0.0.1, starten Sie docker compose up -d und schalten Sie einen Reverse Proxy mit HTTPS davor.

Wie lauten die Standardzugangsdaten von Checkmate?

Es gibt keine. Die erste Person, die sich auf einer neuen Instanz registriert, wird Superadmin. Legen Sie Ihr Konto gleich nach dem ersten Start an, über einen SSH-Tunnel; danach werden Besucher zur Anmeldeseite geleitet, und neue Nutzer kommen per Einladung dazu.

Wie viel Arbeitsspeicher braucht Checkmate?

Die Dokumentation verlangt einen Linux-VPS mit 1 GB Arbeitsspeicher oder mehr. Auf unserem Test-VPS belegte eine frische Installation etwa 300 MB für Checkmate und 280 MB für MongoDB. Die Festplatte wächst mit der Zahl der Monitore, ihrem Intervall und dem aufbewahrten Verlauf, standardmäßig 90 Tage.

Wie sende ich die Alarme von Checkmate per E-Mail?

Richten Sie die SMTP-Verbindung unter Settings, Reiter Email, ein: Host, Port 587 oder 465, Benutzer, Passwort und Absender, dann Save und Test. Legen Sie eine E-Mail-Benachrichtigung mit den zu alarmierenden Adressen an und verknüpfen Sie sie mit Ihren Monitoren. Die Einladungen verwenden dieselben Einstellungen.

Wie sichere ich Checkmate?

Exportieren Sie die MongoDB-Datenbank mit docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db, und bewahren Sie eine Kopie Ihrer Datei .env auf, deren ENCRYPTION_KEY gebraucht wird, um die gespeicherten Geheimnisse zu lesen. Stellen Sie mit mongorestore --archive --gzip --drop wieder her, bei angehaltener Anwendung.

Wie aktualisiere ich Checkmate?

Lesen Sie die Release Notes und erstellen Sie ein Backup, ändern Sie das Image-Tag in der compose.yaml und führen Sie dann docker compose pull und docker compose up -d aus. Die Migrationen der Datenbank laufen beim Start von selbst.

Deckt ein Managed VPS Checkmate ab?

Ein Managed VPS deckt den Server ab: System, Sicherheit, Überwachung und Backups. Unsere Teams betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen. Ein Eingriff in der Anwendung wird nach Stunden oder pauschal abgerechnet.

Quellen und offizielle Dokumentation

Verwandte Leitfäden

Uptime Kuma auf einem Managed VPS hosten: Ihre Dienste dauerhaft überwachenUptime Kuma auf einem Managed VPS zu hosten heißt, Ihre Websites, APIs und Server von einer Maschine aus zu überwachen, die Ihnen gehört und die unsere Teams aktuell halten und Tag und Nacht beaufsichtigen. Uptime Kuma ist freie Software unter der MIT-Lizenz. Dieser Leitfaden folgt der offiziellen Dokumentation: die Installation mit Docker Compose, HTTPS, die Datenbank, die Benachrichtigungen, Backups und Updates.VPS-Backups: was Sie vor Vertragsabschluss prüfen solltenEin VPS-Angebot verspricht fast immer „Backups inklusive“. Hinter diesen zwei Wörtern kann eine Kopie jede Nacht stehen, außerhalb der Maschine aufbewahrt und von Experten wiederhergestellt, oder ein Snapshot auf derselben Festplatte wie der Server. Dieser Leitfaden nennt die Fragen, die den Unterschied machen, erklärt, was jede Antwort bedeutet, und zeigt, wie Sie prüfen, dass sich ein Backup wiederherstellen lässt.Unterschied zwischen Managed und Unmanaged VPS: wer macht wasDer Unterschied zwischen einem Managed und einem Unmanaged VPS hängt an einer einzigen Frage: wer sich um den Server kümmert, sobald er in Betrieb ist. Dabei hat „Managed“ keine offizielle Definition: von einem Hoster zum anderen reicht das Wort von der bloßen Installation des Systems bis zum vollständigen Betrieb des Servers. Dieser Leitfaden zeigt Zeile für Zeile, wer was übernimmt, mit der Zwischenstufe des Supports, und nennt die Fragen, die vor der Unterschrift Klarheit schaffen.
Kontaktieren Sie uns