Hostati Checkmate na Managed VPS-u znači nadzor nad svojim web-stranicama i poslužiteljima držati na stroju koji je vaš, a koji naši timovi održavaju ažurnim i nadziru danju i noću. Checkmate je slobodna aplikacija otvorenog koda za nadzor, pod licencom AGPL-3.0: dostupnost, vremena odziva, incidenti, upozorenja i statusne stranice. Ovaj vodič prati njegovu službenu Docker sliku u inačici v4.0.0, a svaku smo naredbu pokrenuli na Simafri VPS-u prije nego što smo ga napisali: instalaciju s Docker Composeom, HTTPS, prvi račun, monitore i upozorenja, sigurnosne kopije i ažuriranja.
Autor: Simon Vasconcelos Lee
Objavljeno 17. studenoga 2026.Vrijeme čitanja: 12 minuta
ghcr.io/bluewave-labs/checkmate i MongoDB 8.0, s portom objavljenim na 127.0.0.1 iza obrnutog proxyja s HTTPS-om.JWT_SECRET, ENCRYPTION_KEY i svoju javnu adresu u CLIENT_HOST te dodajte NODE_ENV=production, koji referentna datoteka izostavlja.mongodump i čuvajte svoju datoteku .env, a zatim ažurirajte promjenom oznake slike: migracije se pri pokretanju izvode same.Checkmate u redovitim razmacima provjerava vaše usluge, bilježi svaki odgovor i njegovo vrijeme odziva te vas upozorava kad nešto prestane odgovarati. Njegov razvijatelj, BlueWave Labs, opisuje ga kao alat na vlastitom poslužitelju za praćenje hardvera poslužitelja, dostupnosti, vremena odziva i incidenata u stvarnom vremenu.
Checkmate je objavljen pod licencom GNU Affero General Public License, inačica 3 (AGPL-3.0). Možete ga besplatno upotrebljavati, za sebe, svoju tvrtku ili svoje klijente, kopirati ga i mijenjati.
Njezina posebna odredba odnosi se na upotrebu preko mreže: ako izmijenite Checkmate i drugim ljudima omogućite da vašu izmijenjenu inačicu koriste preko mreže, morate im ponuditi njezin izvorni kod. Pokretanje službene slike bez izmjena, kao u ovom vodiču, ne stvara takvu obvezu. Softver se isporučuje bez jamstva.
Dokumentacija postavlja skroman minimum: bilo koji Linux VPS s 1 GB RAM-a ili više. Dodaje da MongoDB troši oko 400 MB na instanci koja svake minute provjerava više od 300 poslužitelja.
Veličina poslužitelja stoga ovisi o broju monitora, njihovu intervalu i povijesti koju čuvate. Na Managed VPS-u opišite nam kako ga upotrebljavate, a mi vam preporučujemo odgovarajuću veličinu.
Od inačice 3.10 Checkmate se isporučuje kao jedna slika, ghcr.io/bluewave-labs/checkmate, koja poslužuje i sučelje i API. MongoDB radi pokraj nje, u vlastitom spremniku. Na poslužitelju s Docker Engineom i njegovim dodatkom Compose, instaliranima iz Dockerova repozitorija za Ubuntu, napravite mapu poput /opt/checkmate i u nju stavite ovaj compose.yaml, izrađen na temelju referentne datoteke projekta:
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:
Dvije tajne vrijednosti idu u datoteku .env pokraj nje, koju Docker Compose čita sam. Stvorite je tako da je može čitati samo root, a zatim pokrenite stog:
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: referentna datoteka objavljuje ga bez adrese, a Docker ga tada otvara na svim adresama poslužitelja. Objavljen lokalno, dostupan je samo preko obrnutog proxyja.CLIENT_HOST je adresa koju vaši korisnici upisuju, s https://. Checkmate je koristi za provjere zahtjeva s drugih izvora i za poveznice u svojim upozorenjima i porukama e-pošte.NODE_ENV=production: README ga traži za stvarne implementacije. Bez njega aplikacija radi u razvojnom načinu, koji isključuje ograničivač broja zahtjeva prema API-ju.ENCRYPTION_KEY je u referentnoj datoteci neobavezan. Šifrira tajne vrijednosti koje Checkmate pohranjuje, a v4.0.0 ga zahtijeva za TLS Docker monitore i za Checkmate Connect. Postavite ga od početka: to je lakše nego dodati ga kasnije.latest i preuzima je pri svakom pokretanju. Puna inačica, ovdje v4.0.0, omogućuje vam da sami odaberete trenutak svakog ažuriranja.mongo-data čuva sve vaše podatke: monitore, provjere, korisnike i postavke.Prvo pokretanje izvodi migracije baze podataka; na našem testnom VPS-u aplikacija je za manje od deset sekundi javila ispravno stanje. Da biste provjerili odgovara li:
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
Prva naredba odgovara s 200. Druga odgovara s "data":false sve dok ne postoji nijedan račun, a s true čim je Superadmin stvoren.
Checkmate nema zadani račun. Prva osoba koja se registrira postaje Superadmin, pa svoj račun stvorite odmah nakon prvog pokretanja, prije nego što adresu otvorite javnosti. SSH tunel donosi port 52345 poslužitelja na vaše računalo, na http://localhost:52345; dodajte -p i SSH port naveden u vašem korisničkom prostoru.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate prikazuje svoju stranicu za registraciju.Od tog je trenutka javna registracija zatvorena: na našem testnom VPS-u svaki je novi posjetitelj upućen na stranicu za prijavu, a onamo je vodila i adresa za registraciju. Ostali se pridružuju pozivnicom, iz odjeljka Team u postavkama računa, s ulogom User ili Admin. Pozivnica se šalje e-poštom, pa su joj potrebne SMTP postavke opisane u nastavku, a njezina poveznica istječe nakon jednog sata.
| Uloga | Što može |
|---|---|
| User | Vidjeti svaki monitor, nadzornu ploču, provjere, incidente, statusne stranice i postavke, bez ikakvih promjena |
| Admin | Sve što može User, uz monitore, kanale obavijesti, incidente, razdoblja održavanja, statusne stranice, pozivnice i globalne postavke, uključujući SMTP |
| Superadmin | Sve što može Admin, uz izravno stvaranje računa, uređivanje drugog korisnika te promjenu uloge ili lozinke |
Od v4.0.0 oznake, statusne stranice i proxyji radnje su rezervirane za Admina: User koji je njima prije mogao upravljati nakon ažuriranja gubi taj pristup.
Spremnik poslužuje Checkmate preko HTTP-a, na portu 52345. HTTPS preuzima obrnuti proxy ispred njega: dokumentacija navodi Caddy, Traefik i nginx. Isprobali smo Caddy, instaliran iz njegova službenog repozitorija za Debian i Ubuntu: sam pribavlja Let’s Encrypt certifikat, obnavlja ga i zadano prosljeđuje zaglavlje Host i zaglavlja X-Forwarded-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST mora sadržavati istu adresu https:// kao proxy. Nakon što je promijenite, pokrenite docker compose up -d kako biste ponovno stvorili spremnik.Upozorenja e-poštom i pozivnice idu preko SMTP veze na razini cijelog poslužitelja, postavljene pod „Settings”, kartica „Email”: poslužitelj, port, korisnik, lozinka i adresa pošiljatelja, zatim „Save” i „Test”. Na Simafri VPS-u koristite SMTP poslužitelj s autentifikacijom, na portu 587 ili 465: uslugu e-pošte vaše domene ili uslugu za slanje. Zatim stvorite obavijest e-poštom s adresama koje treba upozoriti i pridružite je svojim monitorima.
Slack, Discord, Teams, Telegram i ostali kanali stvaraju se na isti način, pod „Notifications”, svaki sa svojom webhook adresom ili tokenom i svaki s gumbom „Test”.
Heartbeat monitor nadzire zadatak koji se izvodi sam, poput noćne sigurnosne kopije. Generirajte ping ključ tima pod „Settings”, kartica „Monitoring” (prikazuje se samo jednom), stvorite monitor Heartbeat sa slugom i prozorom upozorenja, a zatim na kraju zadatka pozovite njegov ping URL:
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 "https://status.example.com/api/v1/heartbeat/<ping-key>/nightly-backup"
Ako u URL dodate /fail ili izlazni kod zadatka, monitor se odmah označava kao nedostupan, bez čekanja da prozor istekne.
Pod „Status pages” Admin objavljuje stranicu koja navodi odabrane monitore i njihovu dostupnost, za vaše klijente ili vaš tim. Od v4.0.0 svaka statusna stranica ima vremensku zonu, zadano UTC.
Sve se nalazi na dva mjesta: u bazi MongoDB, u volumenu mongo-data, i u vašoj datoteci .env. Potonju čuvajte na sigurnom: ENCRYPTION_KEY potreban je za čitanje tajnih vrijednosti pohranjenih u bazi, a JWT_SECRET drži vaše korisnike prijavljenima. Slika MongoDB sadrži mongodump:
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak
Zakažite tu kopiju i šaljite je izvan poslužitelja; heartbeat monitor može vam javiti ako se ikad prestane izvoditi. Postavljene na disk, arhive ulaze i u noćne sigurnosne kopije poslužitelja.
Na istoj ili novoj instalaciji, s istom datotekom .env, zaustavite aplikaciju, učitajte arhivu, a zatim aplikaciju ponovno pokrenite:
docker compose stop checkmate
docker compose exec -T mongodb mongorestore --archive --gzip --drop < checkmate-2026-11-17.archive.gz
docker compose start checkmate
Cijeli smo ciklus isprobali na svom VPS-u: sigurnosna kopija, baza stvarno izbrisana, vraćanje. Monitor i račun su se vratili, a prijava je odmah ponovno radila.
Checkmate v4.0.0 nudi i šifrirane sigurnosne kopije u oblaku preko Checkmate Connecta, neobavezne usluge, besplatne tijekom beta faze, kojoj su potrebni ENCRYPTION_KEY i Superadmin za upis instalacije. Gornje kopije rade i bez nje.
Pročitajte bilješke uz izdanje, napravite sigurnosnu kopiju, promijenite oznaku slike u compose.yaml, a zatim preuzmite novu sliku i ponovno stvorite spremnik. Migracije baze podataka pri pokretanju se izvode same:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump i mongorestore. Nije potrebna nijedna nova varijabla okruženja.checkmate-client, checkmate-backend i checkmate-mongo, koje se više ne ažuriraju. Prijeđite na ghcr.io/bluewave-labs/checkmate i zadržite svoju uslugu MongoDB i njezin volumen; varijable UPTIME_APP_* više se ne čitaju.Checkmate šalje jedno anonimno izvješće dnevno: ID instalacije, inačicu, način instalacije i broj monitora svake vrste, nikada vaše URL-ove ni rezultate. To navodi u svom zapisniku pri pokretanju. Da biste je isključili, dodajte TELEMETRY_ENABLED=false u okruženje usluge checkmate, a zatim pokrenite docker compose up -d.
Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; Checkmate ostaje vaš softver, sa svojim monitorima i vašim postavkama.
| Tema | Naši timovi | Vi |
|---|---|---|
| Poslužitelj | Ažuriranja sustava i sigurnosti, uključujući intervencije na poslužitelju | Trenutak koji odgovara vašem poslovanju |
| Nadzor | Poslužitelj pod nadzorom 24 sata dnevno, 7 dana u tjednu, s intervencijom bez čekanja vašeg poziva | Vaši vlastiti monitori, upozorenja i statusne stranice u Checkmateu |
| Checkmate | Proaktivno praćenje: uočene pogreške, usporavanja, baza podataka i prostor na disku, preporučen ispravak | Njegova instalacija, ažuriranja i postavke, koje primjenjujete vi ili vaš AI asistent |
| Korisnici i upozorenja | Poslužitelj koji ih nosi, nadziran i sigurnosno kopiran | Računi, uloge, pozivnice i kanali obavijesti |
| Sigurnosne kopije | Svake noći, šifrirane i čuvane izvan stroja; vraćanje uključeno | Izvozi baze specifični za Checkmate i zahtjev za vraćanje, kada vam zatreba |
| Migracija | Vaš trenutačni poslužitelj migriran, besplatno | Trenutak prelaska |
Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.
Uz Simafri Managed VPS naši timovi održavaju poslužitelj vaše instance Checkmatea ažurnim, nadziru ga danju i noću i interveniraju bez čekanja vašeg poziva; uz to proaktivno prate vašu instancu i preporučuju vam korisne ispravke, koje primjenjujete vi ili vaš AI asistent. Sigurnosne kopije svake se noći šifriraju i čuvaju izvan stroja, njihovo vraćanje je uključeno, a migracija vašeg trenutačnog poslužitelja je besplatna.
Da. Checkmate je pod licencom AGPL-3.0: možete ga pokretati za sebe, svoj tim ili svoje klijente bez kupnje licence. Ako ga izmijenite i drugima omogućite da ga koriste preko mreže, dijelite svoje izmjene. Preostaje trošak poslužitelja na kojem radi.
Koristite referentni compose.yaml: sliku ghcr.io/bluewave-labs/checkmate i MongoDB 8.0. Stavite JWT_SECRET i ENCRYPTION_KEY u datoteku .env, postavite CLIENT_HOST na svoju https adresu i NODE_ENV na production, objavite port 52345 na 127.0.0.1, pokrenite docker compose up -d i ispred postavite obrnuti proxy s HTTPS-om.
Ne postoje. Prva osoba koja se registrira na novoj instanci postaje Superadmin. Stvorite svoj račun odmah nakon prvog pokretanja, preko SSH tunela; nakon toga posjetitelji se upućuju na stranicu za prijavu, a novi se korisnici pridružuju pozivnicom.
Dokumentacija traži Linux VPS s 1 GB RAM-a ili više. Na našem testnom VPS-u nova je instalacija trošila oko 300 MB za Checkmate i 280 MB za MongoDB. Disk raste s brojem monitora, njihovim intervalom i poviješću koju čuvate, zadano 90 dana.
Postavite SMTP vezu pod Settings, kartica Email: poslužitelj, port 587 ili 465, korisnik, lozinka i pošiljatelj, zatim Save i Test. Stvorite obavijest e-poštom s adresama koje treba upozoriti i pridružite je svojim monitorima. Pozivnice koriste iste postavke.
Izvezite bazu MongoDB naredbom docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db i čuvajte kopiju svoje datoteke .env, čiji je ENCRYPTION_KEY potreban za čitanje pohranjenih tajnih vrijednosti. Vratite je s mongorestore --archive --gzip --drop, dok je aplikacija zaustavljena.
Pročitajte bilješke uz izdanje i napravite sigurnosnu kopiju, promijenite oznaku slike u compose.yaml, a zatim pokrenite docker compose pull i docker compose up -d. Migracije baze podataka pri pokretanju se izvode same.
Managed VPS pokriva poslužitelj: sustav, sigurnost, nadzor i sigurnosne kopije. Naši timovi uz to proaktivno prate vašu instancu i preporučuju korisne ispravke, koje primjenjujete vi. Intervencija u aplikaciji naplaćuje se po satu ili paušalno.
Simafri
Porazgovarajmo o Vašem projektu
Recite nam u nekoliko riječi što trebate: javljamo Vam se brzo.
Hvala! Vaš upit je poslan. Javit ćemo vam se uskoro.
Više volite e-mail? Pišite nam na support@simafri.com.