Găzduirea Checkmate pe un Managed VPS: monitorizare pe propriul server

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.

Simon Vasconcelos Lee Autor: Publicat la 17 noiembrie 2026Timp de citire: 12 minute

Toate ghidurile

Esențialul

  1. Licența AGPL-3.0 vă permite să rulați Checkmate 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.
  2. Instalați-l cu Docker Compose: imaginea all-in-one ghcr.io/bluewave-labs/checkmate și MongoDB 8.0, cu portul publicat pe 127.0.0.1 în spatele unui proxy invers în HTTPS.
  3. Setați 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.
  4. Prima persoană care se înregistrează devine Superadmin: creați-vă contul imediat după prima pornire, iar toți ceilalți se alătură prin invitație.
  5. Salvați baza de date MongoDB cu mongodump și păstrați fișierul .env, apoi actualizați schimbând eticheta imaginii: migrările rulează singure la pornire.

Ce face Checkmate

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.

Ce permite licența AGPL-3.0

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.

Resursele de prevăzut

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

Instalarea cu Docker Compose

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

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:

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:

Terminal, în directorul /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

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:

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

Primul cont, rolurile și invitațiile

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.

Terminal, pe computerul dumneavoastră
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Deschideți http://localhost:52345: Checkmate afișează pagina sa de înregistrare.
  2. Introduceți prenumele, numele, adresa de e-mail și o parolă de cel puțin 8 caractere, cu o majusculă, o minusculă, o cifră și un caracter special.
  3. Înregistrați-vă: ajungeți pe tabloul de bord, conectat ca Superadmin.

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

RolCe poate face
UserSă vadă toate monitoarele, tabloul de bord, verificările, incidentele, paginile de stare și setările, fără să modifice nimic
AdminTot ce poate un User, plus monitoarele, canalele de notificare, incidentele, ferestrele de mentenanță, paginile de stare, invitațiile și setările globale, inclusiv SMTP
SuperadminTot 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.

HTTPS: proxy-ul invers

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

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

Primul monitor și alertele sale

  1. În „Uptime”, faceți clic pe „Create monitor” și alegeți HTTP/HTTPS.
  2. Introduceți adresa de verificat, un nume pe care îl veți recunoaște într-o alertă și un interval: documentația recomandă între unu și cinci minute pentru un serviciu critic.
  3. Salvați: Checkmate rulează imediat prima verificare. Pe VPS-ul nostru de test, monitorul indica serviciul ca disponibil un minut mai târziu.

E-mailul: setările SMTP

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

Monitoarele Heartbeat pentru sarcinile programate

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:

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"

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.

Paginile de stare

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

Backupurile

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:

Terminal, în directorul /opt/checkmate
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.

Restaurarea

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:

Terminal, în directorul /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

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.

Actualizările

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:

Terminal, în directorul /opt/checkmate
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration

Telemetria

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.

Cine ce face pe un Managed VPS

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

SubiectEchipele noastreDumneavoastră
ServerulActualizări de sistem și de securitate, intervenții pe server incluseMomentul potrivit activității dumneavoastră
MonitorizareaServer urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelulPropriile monitoare, alerte și pagini de stare în Checkmate
CheckmateUrmă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 alerteleServerul care le poartă, supravegheat și salvatConturile, 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
MigrareaServerul dumneavoastră actual migrat, gratuitMomentul 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.

Checkmate, pe un server întreținut pentru dumneavoastră

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

Descoperiți gama Managed VPS

Întrebări frecvente

Este Checkmate 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ă.

Cum se instalează Checkmate cu Docker Compose?

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.

Care sunt datele de acces implicite ale Checkmate?

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.

De câtă memorie are nevoie Checkmate?

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.

Cum se trimit alertele Checkmate prin e-mail?

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.

Cum se face backupul pentru Checkmate?

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

Cum se actualizează Checkmate?

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.

Acoperă un Managed VPS și Checkmate?

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.

Surse și documentație oficială

Ghiduri conexe

Găzduirea Uptime Kuma pe un Managed VPS: monitorizați-vă serviciile continuuGăzduirea Uptime Kuma pe un Managed VPS înseamnă să vă monitorizați site-urile, API-urile și serverele de pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. Uptime Kuma este un software liber sub licență MIT. Acest ghid urmează documentația sa oficială: instalarea cu Docker Compose, HTTPS, baza de date, notificările, backupurile și actualizările.Backupurile unui VPS: ce trebuie să verificați înainte de a semnaO ofertă de VPS anunță aproape mereu „backupuri incluse”. În spatele acestor două cuvinte se poate afla o copie făcută în fiecare noapte, păstrată în afara mașinii și restaurată de experți, sau un snapshot pus pe același disc ca serverul. Acest ghid prezintă întrebările care fac diferența, ce înseamnă fiecare răspuns și modul de a verifica faptul că un backup se poate restaura.Diferența dintre VPS administrat și neadministrat: cine ce faceDiferența dintre un VPS administrat și unul neadministrat ține de o singură întrebare: cine se ocupă de server după ce acesta funcționează. Totuși, „administrat” (managed) nu are o definiție oficială: de la un furnizor la altul, cuvântul acoperă orice, de la simpla instalare a sistemului până la exploatarea completă a serverului. Acest ghid arată cine ce face, rând cu rând, inclusiv la nivelul intermediar al asistenței, și oferă întrebările care înlătură ambiguitatea înainte de semnare.
Contactați-ne