Hostovat Checkmate na Managed VPS: sledování dostupnosti na vašem serveru

Hostovat Checkmate na Managed VPS znamená mít dohled nad svými weby a servery na vlastním stroji, který naše týmy udržují aktuální a ve dne i v noci hlídají. Checkmate je svobodná aplikace s otevřeným zdrojovým kódem pro monitoring, pod licencí AGPL-3.0: dostupnost, doby odezvy, incidenty, upozornění a stavové stránky. Tento průvodce sleduje její oficiální obraz Docker ve verzi v4.0.0 a každý příkaz jsme před jeho napsáním spustili na VPS Simafri: instalaci pomocí Docker Compose, HTTPS, první účet, monitory a upozornění, zálohy a aktualizace.

Simon Vasconcelos Lee Autor: Publikováno 17. listopadu 2026Doba čtení: 12 minut

Všichni průvodci

To nejdůležitější

  1. Licence AGPL-3.0 vám dovoluje provozovat Checkmate pro sebe, svůj tým nebo své klienty, aniž byste kupovali licenci; pokud ho upravíte a necháte ostatní používat ho přes síť, sdílíte své změny.
  2. Nainstalujte ho pomocí Docker Compose: obraz typu vše v jednom ghcr.io/bluewave-labs/checkmate a MongoDB 8.0, s portem publikovaným na 127.0.0.1 za reverzní proxy s HTTPS.
  3. Nastavte JWT_SECRET, ENCRYPTION_KEY a svou veřejnou adresu v CLIENT_HOST a přidejte NODE_ENV=production, které referenční soubor neobsahuje.
  4. První člověk, který se zaregistruje, se stane Superadminem: vytvořte si účet hned po prvním spuštění, všichni ostatní se pak připojují na pozvánku.
  5. Zálohujte databázi MongoDB pomocí mongodump a uchovejte svůj soubor .env, a aktualizujte změnou tagu obrazu: migrace se při spuštění provedou samy.

Co Checkmate umí

Checkmate v pravidelných intervalech kontroluje vaše služby, zaznamenává každou odpověď a její dobu odezvy a upozorní vás, když něco přestane odpovídat. Jeho vývojář, BlueWave Labs, ho popisuje jako nástroj pro vlastní hosting, který v reálném čase sleduje hardware serverů, dostupnost, doby odezvy a incidenty.

Co dovoluje licence AGPL-3.0

Checkmate je vydáván pod licencí GNU Affero General Public License, verze 3 (AGPL-3.0). Můžete ho používat zdarma, pro sebe, svou firmu nebo své klienty, kopírovat ho a upravovat.

Její zvláštní ustanovení se týká používání přes síť: pokud Checkmate upravíte a necháte jiné lidi používat svou upravenou verzi přes síť, musíte jim nabídnout její zdrojový kód. Provozování oficiálního obrazu bez úprav, jako v tomto průvodci, žádnou takovou povinnost nezakládá. Software se poskytuje bez záruky.

Prostředky, se kterými počítat

Dokumentace stanovuje skromné minimum: jakýkoli VPS s Linuxem a 1 GB RAM nebo více. Dodává, že MongoDB spotřebuje asi 400 MB na instanci, která každou minutu kontroluje více než 300 serverů.

Velikost serveru tedy závisí na počtu monitorů, jejich intervalu a historii, kterou uchováváte. Na Managed VPS nám popište své použití a doporučíme vám vhodnou velikost.

Instalace pomocí Docker Compose

Od verze 3.10 se Checkmate dodává jako jediný obraz, ghcr.io/bluewave-labs/checkmate, který obsluhuje rozhraní i API. MongoDB běží vedle něj, ve vlastním kontejneru. Na serveru s Docker Engine a jeho pluginem Compose, nainstalovanými z repozitáře Dockeru pro Ubuntu, vytvořte složku, například /opt/checkmate, a vložte do ní tento compose.yaml, vycházející z referenčního souboru projektu:

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:

Oba tajné klíče patří do souboru .env vedle něj, který Docker Compose načte sám. Vytvořte ho tak, aby ho mohl číst jen root, a potom spusťte stack:

Terminál, v /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

První spuštění provede migrace databáze; na našem testovacím VPS hlásila aplikace dobrý stav za méně než deset sekund. Abyste ověřili, že odpovídá:

Terminál
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

První příkaz odpoví 200. Druhý odpovídá "data":false, dokud žádný účet neexistuje, a true, jakmile je Superadmin vytvořen.

První účet, role a pozvánky

Checkmate nemá žádný výchozí účet. První člověk, který se zaregistruje, se stane Superadminem, proto si svůj účet vytvořte hned po prvním spuštění, dřív než adresu otevřete veřejnosti. Tunel SSH přenese port 52345 serveru na váš počítač, na http://localhost:52345; přidejte -p a port SSH uvedený ve vašem zákaznickém prostoru.

Terminál, na vašem počítači
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Otevřete http://localhost:52345: Checkmate zobrazí svou registrační stránku.
  2. Zadejte své jméno, příjmení, e-mailovou adresu a heslo o délce alespoň 8 znaků, s velkým písmenem, malým písmenem, číslicí a speciálním znakem.
  3. Zaregistrujte se: ocitnete se na nástěnce, přihlášeni jako Superadmin.

Od té chvíle je veřejná registrace zavřená: na našem testovacím VPS byl každý nový návštěvník přesměrován na přihlašovací stránku a vedla tam i adresa registrace. Další lidé se připojují na pozvánku, z části Team v nastavení účtu, s rolí User nebo Admin. Pozvánka odchází e-mailem, takže potřebuje níže popsaná nastavení SMTP, a její odkaz vyprší po jedné hodině.

RoleCo smí dělat
UserVidět všechny monitory, nástěnku, kontroly, incidenty, stavové stránky a nastavení, bez možnosti cokoli měnit
AdminVše, co User, a navíc monitory, kanály oznámení, incidenty, okna údržby, stavové stránky, pozvánky a globální nastavení, včetně SMTP
SuperadminVše, co Admin, a navíc přímé vytváření účtů, úpravy jiného uživatele, změna role nebo hesla

Od v4.0.0 jsou štítky, stavové stránky a proxy akcemi Admina: User, který je dříve mohl spravovat, tento přístup po aktualizaci ztrácí.

HTTPS: reverzní proxy

Kontejner obsluhuje Checkmate přes HTTP, na portu 52345. HTTPS zajišťuje reverzní proxy před ním: dokumentace jmenuje Caddy, Traefik a nginx. Otestovali jsme Caddy, nainstalovaný z jeho oficiálního repozitáře pro Debian a Ubuntu: certifikát Let’s Encrypt si sám získá, obnovuje ho a ve výchozím stavu předává hlavičku Host i hlavičky X-Forwarded-*.

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

Váš první monitor a jeho upozornění

  1. V části „Uptime“ klikněte na „Create monitor“ a zvolte HTTP/HTTPS.
  2. Zadejte adresu ke kontrole, název, který v upozornění poznáte, a interval: dokumentace doporučuje jednu až pět minut pro kritickou službu.
  3. Uložte: Checkmate hned provede první kontrolu. Na našem testovacím VPS hlásil monitor o minutu později dostupnost.

E-mail: nastavení SMTP

E-mailová upozornění a pozvánky procházejí připojením SMTP společným pro celý server, nastaveným v „Settings“, na kartě „Email“: hostitel, port, uživatel, heslo a adresa odesílatele, potom „Save“ a „Test“. Na VPS Simafri použijte ověřovaný server SMTP na portu 587 nebo 465: poštovní službu vaší domény nebo službu pro odesílání e-mailů. Potom vytvořte e-mailové oznámení s adresami, které se mají upozorňovat, a připojte ho ke svým monitorům.

Slack, Discord, Teams, Telegram a další kanály se vytvářejí stejně, v části „Notifications“, každý se svou adresou webhooku nebo tokenem a každý s tlačítkem „Test“.

Monitory heartbeat pro vaše plánované úlohy

Monitor heartbeat hlídá úlohu, která běží sama, například noční zálohu. Vygenerujte klíč ping týmu v „Settings“, na kartě „Monitoring“ (zobrazí se jen jednou), vytvořte monitor Heartbeat se slugem a oknem upozornění a potom na konci úlohy zavolejte jeho adresu ping:

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"

Přidání /fail nebo návratového kódu úlohy k adrese označí monitor okamžitě jako nedostupný, bez čekání na uplynutí okna.

Stavové stránky

V části „Status pages“ Admin zveřejní stránku, která vypisuje vybrané monitory a jejich dostupnost, pro vaše klienty nebo váš tým. Od v4.0.0 má každá stavová stránka časové pásmo, ve výchozím stavu UTC.

Zálohy

Vše je na dvou místech: v databázi MongoDB, ve svazku mongo-data, a ve vašem souboru .env. Ten uchovávejte v bezpečí: ENCRYPTION_KEY je potřeba ke čtení tajných údajů uložených v databázi a JWT_SECRET udržuje vaše uživatele přihlášené. Obraz MongoDB obsahuje mongodump:

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

Naplánujte tuto kopii a posílejte ji mimo server; monitor heartbeat vám dá vědět, kdyby se někdy přestala spouštět. Uložené na disku se archivy dostanou i do nočních záloh serveru.

Obnova

Na stejné nebo nové instalaci, se stejným .env, zastavte aplikaci, nahrajte archiv a potom ji znovu spusťte:

Terminál, v /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

Celý cyklus jsme otestovali na našem VPS: záloha, skutečné smazání databáze, obnova. Monitor i účet se vrátily a přihlášení hned znovu fungovalo.

Checkmate v4.0.0 nabízí také šifrované zálohy v cloudu přes Checkmate Connect, volitelnou službu, během bety zdarma, která pro registraci instalace potřebuje ENCRYPTION_KEY a Superadmina. Výše uvedené kopie fungují i bez ní.

Aktualizace

Přečtěte si poznámky k vydání, proveďte zálohu, změňte tag obrazu v compose.yaml, potom stáhněte nový obraz a kontejner znovu vytvořte. Migrace databáze se při spuštění provedou samy:

Terminál, v /opt/checkmate
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration

Telemetrie

Checkmate posílá jedno anonymní hlášení denně: ID instalace, verzi, způsob instalace a počet monitorů každého typu, bez vašich adres a výsledků. Při spuštění to uvádí ve svém protokolu. Chcete-li ji vypnout, přidejte TELEMETRY_ENABLED=false do prostředí služby checkmate a potom spusťte docker compose up -d.

Kdo co dělá na Managed VPS

Vlastní hosting vyžaduje, abyste kromě aplikace udržovali i server. Na Managed VPS se serveru ujímají naše týmy a vaši instanci proaktivně sledují; Checkmate zůstává vaším softwarem, s jeho monitory a vašimi nastaveními.

TémaNaše týmyVy
ServerAktualizace systému a zabezpečení, včetně zásahů na serveruOkamžik, který vyhovuje vašemu provozu
DohledServer sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše voláníVaše vlastní monitory, upozornění a stavové stránky v Checkmate
CheckmateProaktivní sledování: chyby, zpomalení, databáze a místo na disku zachycené, doporučená opravaJeho instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent
Uživatelé a upozorněníServer, který je nese, hlídaný a zálohovanýÚčty, role, pozvánky a kanály oznámení
ZálohyKaždou noc, šifrované a uchovávané mimo stroj; obnova v ceněExporty databáze vlastní Checkmate a žádost o obnovu, když ji potřebujete
MigraceVáš stávající server přenesen zdarmaOkamžik přepnutí

Pokud dáváte přednost tomu, aby naše týmy zasáhly přímo v aplikaci, tato služba se účtuje po hodinách nebo paušálem, s cenovou nabídkou sdělenou před zásahem.

Checkmate na serveru, o který se staráme za vás

S Managed VPS od Simafri udržují naše týmy server vaší instance Checkmate aktuální, hlídají ho ve dne i v noci a zasahují bez čekání na vaše volání; vaši instanci také proaktivně sledují a doporučí vám užitečné opravy, které zapracujete vy nebo váš AI asistent. Zálohy se každou noc šifrují a uchovávají mimo stroj, jejich obnova je v ceně a migrace vašeho stávajícího serveru je zdarma.

Objevit Managed VPS

Časté otázky

Je Checkmate zdarma?

Ano. Checkmate je pod licencí AGPL-3.0: můžete ho provozovat pro sebe, svůj tým nebo své klienty, aniž byste kupovali licenci. Pokud ho upravíte a necháte ostatní používat ho přes síť, sdílíte své změny. Zbývají náklady na server, na kterém běží.

Jak nainstalovat Checkmate pomocí Docker Compose?

Použijte referenční compose.yaml: obraz ghcr.io/bluewave-labs/checkmate a MongoDB 8.0. Vložte JWT_SECRET a ENCRYPTION_KEY do souboru .env, nastavte CLIENT_HOST na svou adresu https a NODE_ENV na production, publikujte port 52345 na 127.0.0.1, spusťte docker compose up -d a předřaďte reverzní proxy s HTTPS.

Jaké jsou výchozí přihlašovací údaje Checkmate?

Žádné nejsou. První člověk, který se na nové instanci zaregistruje, se stane Superadminem. Vytvořte si účet hned po prvním spuštění, přes tunel SSH; potom jsou návštěvníci přesměrováni na přihlašovací stránku a noví uživatelé se připojují na pozvánku.

Kolik paměti Checkmate potřebuje?

Dokumentace požaduje VPS s Linuxem a 1 GB RAM nebo více. Na našem testovacím VPS spotřebovala čerstvá instalace asi 300 MB pro Checkmate a 280 MB pro MongoDB. Disk roste s počtem monitorů, jejich intervalem a historií, kterou uchováváte, ve výchozím stavu 90 dní.

Jak posílat upozornění Checkmate e-mailem?

Nastavte připojení SMTP v Settings, na kartě Email: hostitel, port 587 nebo 465, uživatel, heslo a odesílatel, potom Save a Test. Vytvořte e-mailové oznámení s adresami, které se mají upozorňovat, a připojte ho ke svým monitorům. Pozvánky používají stejná nastavení.

Jak zálohovat Checkmate?

Exportujte databázi MongoDB příkazem docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db a uchovejte kopii svého souboru .env, jehož ENCRYPTION_KEY je potřeba ke čtení uložených tajných údajů. Obnovu proveďte příkazem mongorestore --archive --gzip --drop, se zastavenou aplikací.

Jak aktualizovat Checkmate?

Přečtěte si poznámky k vydání a proveďte zálohu, změňte tag obrazu v compose.yaml, potom spusťte docker compose pull a docker compose up -d. Migrace databáze se při spuštění provedou samy.

Pokrývá Managed VPS i Checkmate?

Managed VPS pokrývá server: systém, zabezpečení, dohled a zálohy. Naše týmy navíc vaši instanci proaktivně sledují a doporučí vám užitečné opravy, které zapracujete vy. Zásah v aplikaci se účtuje po hodinách nebo paušálem.

Zdroje a oficiální dokumentace

Kontaktujte nás