Hostovanie Checkmate na Managed VPS: sledovanie dostupnosti na vašom serveri

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.

Simon Vasconcelos Lee Autor: Publikované 17. novembra 2026Čas čítania: 12 minút

Všetci sprievodcovia

To najdôležitejšie

  1. Licencia AGPL-3.0 vám umožňuje prevádzkovať Checkmate 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.
  2. Nainštalujte ho cez Docker Compose: obraz typu všetko v jednom ghcr.io/bluewave-labs/checkmate a MongoDB 8.0, s portom publikovaným na 127.0.0.1 za reverznou proxy s HTTPS.
  3. Nastavte JWT_SECRET, ENCRYPTION_KEY a svoju verejnú adresu v CLIENT_HOST a pridajte NODE_ENV=production, ktoré referenčný súbor neobsahuje.
  4. Prvý človek, ktorý sa zaregistruje, sa stane Superadminom: vytvorte si účet hneď po prvom spustení, všetci ostatní sa potom pripájajú na pozvánku.
  5. Zálohujte databázu MongoDB pomocou mongodump a uchovajte svoj súbor .env, a aktualizujte zmenou tagu obrazu: migrácie sa pri spustení vykonajú samy.

Čo Checkmate robí

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.

Čo umožňuje licencia AGPL-3.0

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.

Prostriedky, s ktorými treba počítať

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

Inštalácia pomocou Docker Compose

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:

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é 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:

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

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á:

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

Prvý príkaz odpovie 200. Druhý odpovedá "data":false, kým neexistuje žiadny účet, a true, keď je Superadmin vytvorený.

Prvý účet, roly a pozvánky

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.

Terminál, na vašom počítači
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Otvorte http://localhost:52345: Checkmate zobrazí svoju registračnú stránku.
  2. Zadajte svoje meno, priezvisko, e-mailovú adresu a heslo s dĺžkou aspoň 8 znakov, s veľkým písmenom, malým písmenom, číslicou a špeciálnym znakom.
  3. Zaregistrujte sa: ocitnete sa na nástenke, prihlásení ako Superadmin.

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ť
UserVidieť všetky monitory, nástenku, kontroly, incidenty, stavové stránky a nastavenia, bez možnosti čokoľvek meniť
AdminVš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
SuperadminVš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.

HTTPS: reverzná proxy

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

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

Váš prvý monitor a jeho upozornenia

  1. V časti „Uptime“ kliknite na „Create monitor“ a zvoľte HTTP/HTTPS.
  2. Zadajte adresu na kontrolu, názov, ktorý v upozornení spoznáte, a interval: dokumentácia odporúča jednu až päť minút pre kritickú službu.
  3. Uložte: Checkmate hneď vykoná prvú kontrolu. Na našom testovacom VPS hlásil monitor o minútu neskôr dostupnosť.

E-mail: nastavenia SMTP

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

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

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:

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"

Pridanie /fail alebo návratového kódu úlohy k adrese označí monitor okamžite ako nedostupný, bez čakania na uplynutie okna.

Stavové stránky

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.

Zálohy

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:

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

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.

Obnova

Na tej istej alebo novej inštalácii, s rovnakým .env, zastavte aplikáciu, nahrajte archív a potom ju znova spustite:

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

Aktualizácie

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:

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

Telemetria

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.

Kto čo robí na Managed VPS

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émaNaše tímyVy
ServerAktualizácie systému a zabezpečenia, vrátane zásahov na serveriČas, ktorý vyhovuje vašej činnosti
DohľadServer sledovaný 24 hodín denne, 7 dní v týždni, so zásahom bez čakania na vaše zavolanieVaše vlastné monitory, upozornenia a stavové stránky v Checkmate
CheckmateProaktívne sledovanie: chyby, spomalenia, databáza a miesto na disku, s odporúčanou opravouJeho inštalácia, aktualizácie a nastavenia, ktoré zapracujete vy alebo váš AI asistent
Používatelia a upozorneniaServer, ktorý ich nesie, sledovaný a zálohovanýÚčty, roly, pozvánky a kanály oznámení
ZálohyKaždú noc, šifrované a uchovávané mimo stroja; obnova je v ceneExporty databázy špecifické pre Checkmate a žiadosť o obnovu, keď ju potrebujete
MigráciaVáš 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.

Checkmate na serveri, o ktorý sa staráme za vás

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.

Objaviť Managed VPS

Časté otázky

Je Checkmate zadarmo?

Á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ží.

Ako nainštalovať Checkmate pomocou Docker Compose?

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.

Aké sú predvolené prihlasovacie údaje Checkmate?

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

Koľko pamäte Checkmate potrebuje?

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

Ako posielať upozornenia Checkmate e-mailom?

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.

Ako zálohovať Checkmate?

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.

Ako aktualizovať Checkmate?

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.

Pokrýva Managed VPS aj Checkmate?

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.

Zdroje a oficiálna dokumentácia

Kontaktujte nás