Găzduirea Checkmate pe un Managed VPS înseamnă să păstrați supravegherea site-urilor și a serverelor dumneavoastră pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. Checkmate este o aplicație de monitorizare liberă și open source, sub licență AGPL-3.0: disponibilitate, timpi de răspuns, incidente, alerte și pagini de stare. Acest ghid urmează imaginea sa Docker oficială, la versiunea v4.0.0, iar fiecare comandă a fost rulată de noi pe un VPS Simafri înainte de redactare: instalarea cu Docker Compose, HTTPS, primul cont, monitoarele și alertele, backupurile și actualizările.
Autor: Simon Vasconcelos Lee
Publicat la 17 noiembrie 2026Timp de citire: 12 minute
ghcr.io/bluewave-labs/checkmate și MongoDB 8.0, cu portul publicat pe 127.0.0.1 în spatele unui proxy invers în HTTPS.JWT_SECRET, ENCRYPTION_KEY și adresa dumneavoastră publică în CLIENT_HOST, apoi adăugați NODE_ENV=production, pe care fișierul de referință îl omite.mongodump și păstrați fișierul .env, apoi actualizați schimbând eticheta imaginii: migrările rulează singure la pornire.Checkmate vă verifică serviciile la intervale regulate, înregistrează fiecare răspuns și timpul său de răspuns și vă alertează când ceva nu mai răspunde. Dezvoltatorul său, BlueWave Labs, îl descrie ca pe un instrument găzduit pe propriul server pentru urmărirea în timp real a hardware-ului serverelor, a disponibilității, a timpilor de răspuns și a incidentelor.
Checkmate este publicat sub licența GNU Affero General Public License, versiunea 3 (AGPL-3.0). Îl puteți folosi gratuit, pentru dumneavoastră, firma sau clienții dumneavoastră, îl puteți copia și modifica.
Clauza sa specifică privește utilizarea prin rețea: dacă modificați Checkmate și lăsați alte persoane să folosească versiunea modificată prin rețea, trebuie să le oferiți codul ei sursă. Rularea imaginii oficiale nemodificate, ca în acest ghid, nu creează o asemenea obligație. Software-ul este furnizat fără garanție.
Documentația stabilește un prag modest: orice VPS Linux cu 1 GB de RAM sau mai mult. Ea adaugă că MongoDB folosește aproximativ 400 MB pe o instanță care verifică peste 300 de servere în fiecare minut.
Dimensiunea serverului depinde deci de numărul de monitoare, de intervalul lor și de istoricul pe care îl păstrați. Pe un Managed VPS, descrieți-ne utilizarea dumneavoastră și vă recomandăm dimensiunea potrivită.
Începând cu versiunea 3.10, Checkmate este livrat ca o singură imagine, ghcr.io/bluewave-labs/checkmate, care servește atât interfața, cât și API-ul. MongoDB rulează alături, în propriul container. Pe un server cu Docker Engine și pluginul său Compose, instalate din depozitul Docker pentru Ubuntu, creați un director precum /opt/checkmate și puneți în el acest compose.yaml, realizat pe baza fișierului de referință al proiectului:
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:
Cele două secrete merg într-un fișier .env alăturat, pe care Docker Compose îl citește singur. Creați-l astfel încât să poată fi citit doar de root, apoi porniți ansamblul:
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: fișierul de referință îl publică fără adresă, iar Docker îl deschide atunci pe toate adresele serverului. Publicat local, el este accesibil doar prin proxy-ul invers.CLIENT_HOST este adresa pe care o tastează utilizatorii, cu https://. Checkmate o folosește pentru verificările cererilor venite din alte origini și pentru linkurile din alertele și e-mailurile sale.NODE_ENV=production: README-ul îl cere pentru implementările reale. Fără el, aplicația rulează în modul de dezvoltare, care dezactivează limitatorul de cereri al API-ului.ENCRYPTION_KEY este opțională în fișierul de referință. Ea criptează secretele pe care Checkmate le stochează, iar v4.0.0 o cere pentru monitoarele Docker cu TLS și pentru Checkmate Connect. Setați-o de la început: este mai simplu decât să o adăugați mai târziu.latest și o descarcă la fiecare pornire. O versiune completă, aici v4.0.0, vă lasă să alegeți momentul fiecărei actualizări.mongo-data păstrează toate datele dumneavoastră: monitoarele, verificările, utilizatorii și setările.Prima pornire rulează migrările bazei de date; pe VPS-ul nostru de test, aplicația s-a raportat funcțională în mai puțin de zece secunde. Pentru a verifica dacă răspunde:
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
Prima comandă răspunde 200. A doua răspunde "data":false cât timp nu există niciun cont și true odată ce Superadminul a fost creat.
Checkmate nu are niciun cont implicit. Prima persoană care se înregistrează devine Superadmin, așa că creați-vă contul imediat după prima pornire, înainte de a deschide adresa publicului. Un tunel SSH aduce portul 52345 al serverului pe computerul dumneavoastră, la http://localhost:52345; adăugați -p și portul SSH indicat în spațiul dumneavoastră de client.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate afișează pagina sa de înregistrare.De atunci, înregistrarea publică este închisă: pe VPS-ul nostru de test, fiecare vizitator nou a fost trimis la pagina de conectare, iar adresa de înregistrare ducea tot acolo. Celelalte persoane se alătură prin invitație, din secțiunea Team a setărilor contului, cu rolul User sau Admin. Invitația pleacă prin e-mail, deci are nevoie de setările SMTP de mai jos, iar linkul ei expiră după o oră.
| Rol | Ce poate face |
|---|---|
| User | Să vadă toate monitoarele, tabloul de bord, verificările, incidentele, paginile de stare și setările, fără să modifice nimic |
| Admin | Tot ce poate un User, plus monitoarele, canalele de notificare, incidentele, ferestrele de mentenanță, paginile de stare, invitațiile și setările globale, inclusiv SMTP |
| Superadmin | Tot ce poate un Admin, plus crearea directă de conturi, editarea altui utilizator, schimbarea unui rol sau a unei parole |
Începând cu v4.0.0, etichetele, paginile de stare și proxy-urile sunt acțiuni rezervate Adminului: un User care le putea gestiona înainte pierde acest acces după actualizare.
Containerul servește Checkmate în HTTP, pe portul 52345. HTTPS revine unui proxy invers plasat în față: documentația numește Caddy, Traefik și nginx. Am testat Caddy, instalat din depozitul său oficial pentru Debian și Ubuntu: obține singur certificatul Let’s Encrypt, îl reînnoiește și transmite implicit antetul Host și antetele X-Forwarded-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST trebuie să conțină aceeași adresă https:// ca proxy-ul. După ce o schimbați, rulați docker compose up -d pentru a recrea containerul.Alertele prin e-mail și invitațiile trec printr-o conexiune SMTP comună întregului server, setată în „Settings”, fila „Email”: gazda, portul, utilizatorul, parola și adresa expeditorului, apoi „Save” și „Test”. Pe un VPS Simafri, folosiți un server SMTP autentificat, pe portul 587 sau 465: serviciul de e-mail al domeniului dumneavoastră sau un serviciu de trimitere. Creați apoi o notificare prin e-mail cu adresele de alertat și atașați-o monitoarelor dumneavoastră.
Slack, Discord, Teams, Telegram și celelalte canale se creează la fel, în „Notifications”, fiecare cu adresa sa de webhook sau cu tokenul său și fiecare cu un buton „Test”.
Un monitor Heartbeat supraveghează o sarcină care rulează singură, precum un backup de noapte. Generați cheia de ping a echipei în „Settings”, fila „Monitoring” (este afișată o singură dată), creați un monitor Heartbeat cu un slug și o fereastră de alertă, apoi apelați URL-ul său de ping la sfârșitul sarcinii:
0 3 * * * /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 "https://status.example.com/api/v1/heartbeat/<ping-key>/nightly-backup"
Dacă adăugați /fail sau codul de ieșire al sarcinii la URL, monitorul este marcat imediat ca indisponibil, fără să se aștepte trecerea ferestrei.
În „Status pages”, un Admin publică o pagină care listează monitoarele alese și disponibilitatea lor, pentru clienții sau echipa dumneavoastră. Începând cu v4.0.0, fiecare pagină de stare are un fus orar, implicit UTC.
Totul se află în două locuri: baza de date MongoDB, în volumul mongo-data, și fișierul dumneavoastră .env. Păstrați-l pe acesta din urmă în siguranță: ENCRYPTION_KEY este necesară pentru a citi secretele stocate în baza de date, iar JWT_SECRET îi menține conectați pe utilizatori. Imaginea MongoDB include mongodump:
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak
Programați această copie și trimiteți-o în afara serverului; un monitor Heartbeat vă poate anunța dacă nu mai rulează vreodată. Păstrate pe disc, arhivele intră și în backupurile de noapte ale serverului.
Pe aceeași instalare sau pe una nouă, cu același .env, opriți aplicația, încărcați arhiva, apoi porniți-o din nou:
docker compose stop checkmate
docker compose exec -T mongodb mongorestore --archive --gzip --drop < checkmate-2026-11-17.archive.gz
docker compose start checkmate
Am testat întregul ciclu pe VPS-ul nostru: backup, baza de date ștearsă efectiv, restaurare. Monitorul și contul au revenit, iar conectarea a funcționat din nou imediat.
Checkmate v4.0.0 oferă și backupuri criptate în cloud prin Checkmate Connect, un serviciu opțional, gratuit pe durata versiunii beta, care are nevoie de ENCRYPTION_KEY și de un Superadmin pentru a înrola instalarea. Copiile de mai sus funcționează și fără el.
Citiți notele versiunii, faceți un backup, schimbați eticheta imaginii în compose.yaml, apoi descărcați noua imagine și recreați containerul. Migrările bazei de date rulează singure la pornire:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump și mongorestore. Nu este necesară nicio variabilă de mediu nouă.checkmate-client, checkmate-backend și checkmate-mongo, care nu mai sunt actualizate. Treceți la ghcr.io/bluewave-labs/checkmate și păstrați serviciul MongoDB și volumul său; variabilele UPTIME_APP_* nu mai sunt citite.Checkmate trimite un raport anonim pe zi: un ID al instalării, versiunea, modul de instalare și numărul de monitoare de fiecare tip, niciodată URL-urile sau rezultatele dumneavoastră. O spune în jurnalul său la pornire. Pentru a o dezactiva, adăugați TELEMETRY_ENABLED=false în mediul serviciului checkmate, apoi rulați docker compose up -d.
Găzduirea pe propriul server cere să țineți serverul pe lângă aplicație. Pe un Managed VPS, echipele noastre preiau serverul și vă urmăresc proactiv instanța; Checkmate rămâne software-ul dumneavoastră, cu monitoarele sale și setările dumneavoastră.
| Subiect | Echipele noastre | Dumneavoastră |
|---|---|---|
| Serverul | Actualizări de sistem și de securitate, intervenții pe server incluse | Momentul potrivit activității dumneavoastră |
| Monitorizarea | Server urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelul | Propriile monitoare, alerte și pagini de stare în Checkmate |
| Checkmate | Urmărire proactivă: erori, încetiniri, baza de date și spațiu pe disc depistate, corectură recomandată | Instalarea, actualizările și setările sale, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI |
| Utilizatorii și alertele | Serverul care le poartă, supravegheat și salvat | Conturile, rolurile, invitațiile și canalele de notificare |
| Backupurile | În fiecare noapte, criptate și păstrate în afara mașinii; restaurare inclusă | Exporturile proprii ale bazei de date Checkmate și cererea de restaurare, când aveți nevoie de ea |
| Migrarea | Serverul dumneavoastră actual migrat, gratuit | Momentul trecerii |
Dacă preferați ca echipele noastre să intervină în aplicația însăși, această prestație se facturează la oră sau la preț fix, cu o ofertă comunicată înainte de intervenție.
Cu un Managed VPS Simafri, echipele noastre țin la zi serverul instanței dumneavoastră Checkmate, îl monitorizează zi și noapte și intervin fără a vă aștepta apelul; ele vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI. Backupurile sunt criptate în fiecare noapte și păstrate în afara mașinii, restaurarea lor este inclusă, iar migrarea serverului actual este gratuită.
Da. Checkmate este sub licență AGPL-3.0: îl puteți rula pentru dumneavoastră, echipa sau clienții dumneavoastră fără nicio licență de cumpărat. Dacă îl modificați și îi lăsați pe alții să îl folosească prin rețea, vă partajați modificările. Rămâne costul serverului pe care rulează.
Folosiți compose.yaml de referință: imaginea ghcr.io/bluewave-labs/checkmate și MongoDB 8.0. Puneți JWT_SECRET și ENCRYPTION_KEY într-un fișier .env, setați CLIENT_HOST la adresa dumneavoastră https și NODE_ENV la production, publicați portul 52345 pe 127.0.0.1, rulați docker compose up -d și puneți în față un proxy invers în HTTPS.
Nu există. Prima persoană care se înregistrează pe o instanță nouă devine Superadmin. Creați-vă contul imediat după prima pornire, printr-un tunel SSH; după aceea, vizitatorii sunt trimiși la pagina de conectare, iar utilizatorii noi se alătură prin invitație.
Documentația cere un VPS Linux cu 1 GB de RAM sau mai mult. Pe VPS-ul nostru de test, o instalare proaspătă folosea aproximativ 300 MB pentru Checkmate și 280 MB pentru MongoDB. Discul crește cu numărul de monitoare, cu intervalul lor și cu istoricul păstrat, implicit 90 de zile.
Setați conexiunea SMTP în Settings, fila Email: gazda, portul 587 sau 465, utilizatorul, parola și expeditorul, apoi Save și Test. Creați o notificare prin e-mail cu adresele de alertat și atașați-o monitoarelor dumneavoastră. Invitațiile folosesc aceleași setări.
Exportați baza de date MongoDB cu docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db și păstrați o copie a fișierului .env, a cărui ENCRYPTION_KEY este necesară pentru a citi secretele stocate. Restaurați cu mongorestore --archive --gzip --drop, cu aplicația oprită.
Citiți notele versiunii și faceți un backup, schimbați eticheta imaginii în compose.yaml, apoi rulați docker compose pull și docker compose up -d. Migrările bazei de date rulează singure la pornire.
Un Managed VPS acoperă serverul: sistem, securitate, monitorizare și backupuri. Echipele noastre vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră. O intervenție în aplicație se facturează la oră sau la preț fix.
Simafri
Să discutăm despre site-ul dumneavoastră
Povestiți-ne despre proiectul dumneavoastră în câteva cuvinte: vă vom răspunde rapid.
Mulțumim! Cererea dumneavoastră a fost trimisă. Vă vom răspunde în curând.
Preferați e-mailul? Scrieți-ne la support@simafri.com.