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.
Autor: Simon Vasconcelos Lee
Publikováno 17. listopadu 2026Doba čtení: 12 minut
ghcr.io/bluewave-labs/checkmate a MongoDB 8.0, s portem publikovaným na 127.0.0.1 za reverzní proxy s HTTPS.JWT_SECRET, ENCRYPTION_KEY a svou veřejnou adresu v CLIENT_HOST a přidejte NODE_ENV=production, které referenční soubor neobsahuje.mongodump a uchovejte svůj soubor .env, a aktualizujte změnou tagu obrazu: migrace se při spuštění provedou samy.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.
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.
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.
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:
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:
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: referenční soubor ho publikuje bez adresy a Docker ho pak otevře na všech adresách serveru. Publikovaný lokálně je dostupný jen přes reverzní proxy.CLIENT_HOST je adresa, kterou zadávají vaši uživatelé, s https://. Checkmate ji používá pro kontroly požadavků z jiných domén (cross-origin) a pro odkazy ve svých upozorněních a e-mailech.NODE_ENV=production: README ho vyžaduje u skutečných nasazení. Bez něj aplikace běží ve vývojovém režimu, který vypíná omezovač počtu požadavků na API.ENCRYPTION_KEY je v referenčním souboru volitelný. Šifruje tajné údaje, které Checkmate ukládá, a v4.0.0 ho vyžaduje pro monitory Docker s TLS a pro Checkmate Connect. Nastavte ho hned od začátku: je to snazší než ho přidávat později.latest a stahuje ho při každém spuštění. Plná verze, zde v4.0.0, vám dovolí zvolit okamžik každé aktualizace.mongo-data uchovává všechna vaše data: monitory, kontroly, uživatele a nastavení.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á:
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.
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.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate zobrazí svou registrační stránku.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ě.
| Role | Co smí dělat |
|---|---|
| User | Vidět všechny monitory, nástěnku, kontroly, incidenty, stavové stránky a nastavení, bez možnosti cokoli měnit |
| Admin | Vš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 |
| Superadmin | Vš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í.
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-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST musí obsahovat stejnou adresu https:// jako proxy. Po její změně spusťte docker compose up -d, aby se kontejner znovu vytvořil.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“.
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:
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.
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.
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:
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.
Na stejné nebo nové instalaci, se stejným .env, zastavte aplikaci, nahrajte archiv a potom ji znovu spusťte:
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í.
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:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump a mongorestore. Žádná nová proměnná prostředí není nutná.checkmate-client, checkmate-backend a checkmate-mongo, které se už neaktualizují. Přejděte na ghcr.io/bluewave-labs/checkmate a ponechte si službu MongoDB i její svazek; proměnné UPTIME_APP_* se už nečtou.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.
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éma | Naše týmy | Vy |
|---|---|---|
| Server | Aktualizace systému a zabezpečení, včetně zásahů na serveru | Okamžik, který vyhovuje vašemu provozu |
| Dohled | Server 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 |
| Checkmate | Proaktivní sledování: chyby, zpomalení, databáze a místo na disku zachycené, doporučená oprava | Jeho 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álohy | Každou noc, šifrované a uchovávané mimo stroj; obnova v ceně | Exporty databáze vlastní Checkmate a žádost o obnovu, když ji potřebujete |
| Migrace | Váš stávající server přenesen zdarma | Okamž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.
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.
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ěží.
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.
Žá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.
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í.
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í.
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í.
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.
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.
Simafri
Promluvme si o vašem záměru
Řekněte nám v pár slovech, co potřebujete: rychle se vám ozveme.
Děkujeme! Vaše zpráva byla odeslána. Brzy se vám ozveme.
Máte raději e-mail? Napište nám na support@simafri.com.