Hostovanie Checkmate na Managed VPS znamená mať dohľad nad svojimi webmi a servermi na vlastnom stroji, ktorý naše tímy udržiavajú aktuálny a dohliadajú naň vo dne v noci. Checkmate je slobodná aplikácia s otvoreným zdrojovým kódom na monitoring, pod licenciou AGPL-3.0: dostupnosť, časy odozvy, incidenty, upozornenia a stavové stránky. Tento sprievodca postupuje podľa jej oficiálneho obrazu Docker vo verzii v4.0.0 a každý príkaz sme pred jeho napísaním spustili na VPS Simafri: inštalácia cez Docker Compose, HTTPS, prvý účet, monitory a upozornenia, zálohy a aktualizácie.
Autor: Simon Vasconcelos Lee
Publikované 17. novembra 2026Čas čítania: 12 minút
ghcr.io/bluewave-labs/checkmate a MongoDB 8.0, s portom publikovaným na 127.0.0.1 za reverznou proxy s HTTPS.JWT_SECRET, ENCRYPTION_KEY a svoju verejnú adresu v CLIENT_HOST a pridajte NODE_ENV=production, ktoré referenčný súbor neobsahuje.mongodump a uchovajte svoj súbor .env, a aktualizujte zmenou tagu obrazu: migrácie sa pri spustení vykonajú samy.Checkmate v pravidelných intervaloch kontroluje vaše služby, zaznamenáva každú odpoveď a jej čas odozvy a upozorní vás, keď niečo prestane odpovedať. Jeho vývojár, BlueWave Labs, ho opisuje ako nástroj na vlastný hosting, ktorý v reálnom čase sleduje hardvér serverov, dostupnosť, časy odozvy a incidenty.
Checkmate vychádza pod licenciou GNU Affero General Public License, verzia 3 (AGPL-3.0). Môžete ho používať bezplatne, pre seba, svoju firmu alebo svojich klientov, kopírovať ho a upravovať.
Jej osobitné ustanovenie sa týka používania cez sieť: ak Checkmate upravíte a necháte iných ľudí používať vašu upravenú verziu cez sieť, musíte im ponúknuť jej zdrojový kód. Prevádzka oficiálneho obrazu bez úprav, ako v tomto sprievodcovi, žiadnu takú povinnosť nezakladá. Softvér sa poskytuje bez záruky.
Dokumentácia stanovuje skromné minimum: akýkoľvek VPS s Linuxom a 1 GB RAM alebo viac. Dodáva, že MongoDB spotrebuje asi 400 MB na inštancii, ktorá každú minútu kontroluje viac ako 300 serverov.
Veľkosť servera teda závisí od počtu monitorov, ich intervalu a histórie, ktorú uchovávate. Na Managed VPS nám opíšte svoje používanie a odporučíme vám vhodnú veľkosť.
Od verzie 3.10 sa Checkmate dodáva ako jediný obraz, ghcr.io/bluewave-labs/checkmate, ktorý obsluhuje rozhranie aj API. MongoDB beží vedľa neho, vo vlastnom kontajneri. Na serveri s Docker Engine a jeho pluginom Compose, nainštalovanými z repozitára Dockera pre Ubuntu, vytvorte priečinok, napríklad /opt/checkmate, a vložte doň tento compose.yaml, vychádzajúci z referenčného súboru 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é kľúče patria do súboru .env vedľa neho, ktorý Docker Compose načíta sám. Vytvorte ho tak, aby ho mohol čítať len root, a potom spustite 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ý súbor ho publikuje bez adresy a Docker ho potom otvorí na všetkých adresách servera. Publikovaný lokálne je dostupný len cez reverznú proxy.CLIENT_HOST je adresa, ktorú zadávajú vaši používatelia, s https://. Checkmate ju používa na kontroly požiadaviek z iných domén (cross-origin) a na odkazy vo svojich upozorneniach a e-mailoch.NODE_ENV=production: README ho vyžaduje pri skutočných nasadeniach. Bez neho aplikácia beží vo vývojovom režime, ktorý vypína obmedzovač počtu požiadaviek na API.ENCRYPTION_KEY je v referenčnom súbore voliteľný. Šifruje tajné údaje, ktoré Checkmate ukladá, a v4.0.0 ho vyžaduje pre monitory Docker s TLS a pre Checkmate Connect. Nastavte ho hneď od začiatku: je to jednoduchšie, ako ho pridávať neskôr.latest a sťahuje ho pri každom spustení. Úplná verzia, tu v4.0.0, vám umožní zvoliť okamih každej aktualizácie.mongo-data uchováva všetky vaše údaje: monitory, kontroly, používateľov a nastavenia.Prvé spustenie vykoná migrácie databázy; na našom testovacom VPS hlásila aplikácia dobrý stav za menej ako desať sekúnd. Ak chcete overiť, že odpovedá:
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
Prvý príkaz odpovie 200. Druhý odpovedá "data":false, kým neexistuje žiadny účet, a true, keď je Superadmin vytvorený.
Checkmate nemá žiadny predvolený účet. Prvý človek, ktorý sa zaregistruje, sa stane Superadminom, preto si svoj účet vytvorte hneď po prvom spustení, skôr než adresu otvoríte verejnosti. Tunel SSH prenesie port 52345 servera na váš počítač, na http://localhost:52345; pridajte -p a port SSH uvedený vo vašej zákazníckej zóne.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate zobrazí svoju registračnú stránku.Od tej chvíle je verejná registrácia zatvorená: na našom testovacom VPS bol každý nový návštevník presmerovaný na prihlasovaciu stránku a viedla tam aj adresa registrácie. Ďalší ľudia sa pripájajú na pozvánku, z časti Team v nastaveniach účtu, s rolou User alebo Admin. Pozvánka odchádza e-mailom, takže potrebuje nižšie opísané nastavenia SMTP, a jej odkaz vyprší po jednej hodine.
| Rola | Čo môže robiť |
|---|---|
| User | Vidieť všetky monitory, nástenku, kontroly, incidenty, stavové stránky a nastavenia, bez možnosti čokoľvek meniť |
| Admin | Všetko, čo User, a navyše monitory, kanály oznámení, incidenty, okná údržby, stavové stránky, pozvánky a globálne nastavenia, vrátane SMTP |
| Superadmin | Všetko, čo Admin, a navyše priame vytváranie účtov, úpravy iného používateľa, zmena roly alebo hesla |
Od v4.0.0 sú štítky, stavové stránky a proxy akciami Admina: User, ktorý ich predtým mohol spravovať, tento prístup po aktualizácii stráca.
Kontajner obsluhuje Checkmate cez HTTP, na porte 52345. HTTPS zabezpečuje reverzná proxy pred ním: dokumentácia menuje Caddy, Traefik a nginx. Otestovali sme Caddy, nainštalovaný z jeho oficiálneho repozitára pre Debian a Ubuntu: certifikát Let’s Encrypt si sám získa, obnovuje ho a predvolene odovzdáva hlavičku Host aj hlavičky X-Forwarded-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST musí obsahovať rovnakú adresu https:// ako proxy. Po jej zmene spustite docker compose up -d, aby sa kontajner znova vytvoril.E-mailové upozornenia a pozvánky prechádzajú pripojením SMTP spoločným pre celý server, nastaveným v „Settings“, na karte „Email“: hostiteľ, port, používateľ, heslo a adresa odosielateľa, potom „Save“ a „Test“. Na VPS Simafri použite overovaný server SMTP na porte 587 alebo 465: poštovú službu vašej domény alebo službu na odosielanie e-mailov. Potom vytvorte e-mailové oznámenie s adresami, ktoré sa majú upozorňovať, a pripojte ho k svojim monitorom.
Slack, Discord, Teams, Telegram a ďalšie kanály sa vytvárajú rovnako, v časti „Notifications“, každý so svojou adresou webhooku alebo tokenom a každý s tlačidlom „Test“.
Monitor heartbeat stráži úlohu, ktorá beží sama, napríklad nočnú zálohu. Vygenerujte kľúč ping tímu v „Settings“, na karte „Monitoring“ (zobrazí sa len raz), vytvorte monitor Heartbeat so slugom a oknom upozornenia a potom na konci úlohy zavolajte 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"
Pridanie /fail alebo návratového kódu úlohy k adrese označí monitor okamžite ako nedostupný, bez čakania na uplynutie okna.
V časti „Status pages“ Admin zverejní stránku, ktorá vypisuje vybrané monitory a ich dostupnosť, pre vašich klientov alebo váš tím. Od v4.0.0 má každá stavová stránka časové pásmo, predvolene UTC.
Všetko je na dvoch miestach: v databáze MongoDB, vo zväzku mongo-data, a vo vašom súbore .env. Ten uchovávajte v bezpečí: ENCRYPTION_KEY je potrebný na čítanie tajných údajov uložených v databáze a JWT_SECRET udržiava vašich používateľov prihlásených. 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
Túto kópiu naplánujte a posielajte ju mimo servera; monitor heartbeat vám dá vedieť, ak by sa niekedy prestala spúšťať. Uložené na disku sa archívy dostanú aj do nočných záloh servera.
Na tej istej alebo novej inštalácii, s rovnakým .env, zastavte aplikáciu, nahrajte archív a potom ju znova spustite:
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 sme otestovali na našom VPS: záloha, skutočné vymazanie databázy, obnova. Monitor aj účet sa vrátili a prihlásenie hneď znova fungovalo.
Checkmate v4.0.0 ponúka aj šifrované zálohy v cloude cez Checkmate Connect, voliteľnú službu, počas bety bezplatnú, ktorá na registráciu inštalácie potrebuje ENCRYPTION_KEY a Superadmina. Vyššie uvedené kópie fungujú aj bez nej.
Prečítajte si poznámky k vydaniu, urobte zálohu, zmeňte tag obrazu v compose.yaml, potom stiahnite nový obraz a kontajner znova vytvorte. Migrácie databázy sa pri spustení vykonajú samy:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump a mongorestore. Žiadna nová premenná prostredia nie je potrebná.checkmate-client, checkmate-backend a checkmate-mongo, ktoré sa už neaktualizujú. Prejdite na ghcr.io/bluewave-labs/checkmate a ponechajte si službu MongoDB aj jej zväzok; premenné UPTIME_APP_* sa už nečítajú.Checkmate posiela jedno anonymné hlásenie denne: ID inštalácie, verziu, spôsob inštalácie a počet monitorov každého typu, bez vašich adries a výsledkov. Pri spustení to uvádza vo svojom zázname. Ak ju chcete vypnúť, pridajte TELEMETRY_ENABLED=false do prostredia služby checkmate a potom spustite docker compose up -d.
Hostovanie na vlastnom serveri vyžaduje popri aplikácii starať sa aj o server. Na Managed VPS preberajú server naše tímy a vašu inštanciu proaktívne sledujú; Checkmate zostáva vaším softvérom, s jeho monitormi a vašimi nastaveniami.
| Téma | Naše tímy | Vy |
|---|---|---|
| Server | Aktualizácie systému a zabezpečenia, vrátane zásahov na serveri | Čas, ktorý vyhovuje vašej činnosti |
| Dohľad | Server sledovaný 24 hodín denne, 7 dní v týždni, so zásahom bez čakania na vaše zavolanie | Vaše vlastné monitory, upozornenia a stavové stránky v Checkmate |
| Checkmate | Proaktívne sledovanie: chyby, spomalenia, databáza a miesto na disku, s odporúčanou opravou | Jeho inštalácia, aktualizácie a nastavenia, ktoré zapracujete vy alebo váš AI asistent |
| Používatelia a upozornenia | Server, ktorý ich nesie, sledovaný a zálohovaný | Účty, roly, pozvánky a kanály oznámení |
| Zálohy | Každú noc, šifrované a uchovávané mimo stroja; obnova je v cene | Exporty databázy špecifické pre Checkmate a žiadosť o obnovu, keď ju potrebujete |
| Migrácia | Váš súčasný server prenesený zdarma | Čas prepnutia |
Ak by ste uprednostnili, aby naše tímy zasiahli priamo v aplikácii, táto služba sa fakturuje hodinovo alebo paušálne, s cenovou ponukou oznámenou pred zásahom.
S Managed VPS od Simafri udržiavajú naše tímy server vašej inštancie Checkmate aktuálny, sledujú ho vo dne v noci a zasahujú bez čakania na vaše zavolanie; vašu inštanciu navyše proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy alebo váš AI asistent. Zálohy sa každú noc šifrujú a uchovávajú mimo stroja, ich obnova je v cene a migrácia vášho súčasného servera je zdarma.
Áno. Checkmate je pod licenciou AGPL-3.0: môžete ho prevádzkovať pre seba, svoj tím alebo svojich klientov bez kupovania licencie. Ak ho upravíte a necháte ostatných používať ho cez sieť, zdieľate svoje zmeny. Zostávajú náklady na server, na ktorom beží.
Použite referenčný compose.yaml: obraz ghcr.io/bluewave-labs/checkmate a MongoDB 8.0. Vložte JWT_SECRET a ENCRYPTION_KEY do súboru .env, nastavte CLIENT_HOST na svoju adresu https a NODE_ENV na production, publikujte port 52345 na 127.0.0.1, spustite docker compose up -d a predraďte reverznú proxy s HTTPS.
Žiadne nie sú. Prvý človek, ktorý sa na novej inštancii zaregistruje, sa stane Superadminom. Vytvorte si účet hneď po prvom spustení, cez tunel SSH; potom sú návštevníci presmerovaní na prihlasovaciu stránku a noví používatelia sa pripájajú na pozvánku.
Dokumentácia požaduje VPS s Linuxom a 1 GB RAM alebo viac. Na našom testovacom VPS spotrebovala čerstvá inštalácia asi 300 MB pre Checkmate a 280 MB pre MongoDB. Disk rastie s počtom monitorov, ich intervalom a históriou, ktorú uchovávate, predvolene 90 dní.
Nastavte pripojenie SMTP v Settings, na karte Email: hostiteľ, port 587 alebo 465, používateľ, heslo a odosielateľ, potom Save a Test. Vytvorte e-mailové oznámenie s adresami, ktoré sa majú upozorňovať, a pripojte ho k svojim monitorom. Pozvánky používajú rovnaké nastavenia.
Exportujte databázu MongoDB príkazom docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db a uchovajte kópiu svojho súboru .env, ktorého ENCRYPTION_KEY je potrebný na čítanie uložených tajných údajov. Obnovu vykonajte príkazom mongorestore --archive --gzip --drop, so zastavenou aplikáciou.
Prečítajte si poznámky k vydaniu a urobte zálohu, zmeňte tag obrazu v compose.yaml, potom spustite docker compose pull a docker compose up -d. Migrácie databázy sa pri spustení vykonajú samy.
Managed VPS pokrýva server: systém, zabezpečenie, dohľad a zálohy. Naše tímy navyše vašu inštanciu proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy. Zásah v aplikácii sa fakturuje hodinovo alebo paušálne.
Simafri
Porozprávajme sa o vašom zámere
Povedzte nám v pár slovách, čo potrebujete: rýchlo sa vám ozveme.
Ďakujeme! Vaša žiadosť bola odoslaná. Čoskoro sa vám ozveme.
Máte radšej e-mail? Napíšte nám na support@simafri.com.