Hosting Checkmate na Managed VPS: monitoring dostępności na Państwa serwerze

Hosting Checkmate na Managed VPS oznacza, że nadzór nad Państwa stronami i serwerami pozostaje na maszynie, która należy do Państwa, a nasze zespoły dbają o jej aktualność i nadzorują ją dniem i nocą. Checkmate to wolna, otwartoźródłowa aplikacja do monitoringu na licencji AGPL-3.0: dostępność, czasy odpowiedzi, incydenty, alerty i strony statusu. Ten poradnik podąża za jej oficjalnym obrazem Docker w wersji v4.0.0, a każde polecenie uruchomiliśmy na VPS Simafri przed napisaniem poradnika: instalacja przez Docker Compose, HTTPS, pierwsze konto, monitory i alerty, kopie zapasowe i aktualizacje.

Simon Vasconcelos Lee Autor: Opublikowano 17 listopada 2026Czas czytania: 12 minut

Wszystkie poradniki

W skrócie

  1. Licencja AGPL-3.0 pozwala uruchamiać Checkmate dla siebie, swojego zespołu lub klientów bez zakupu licencji; jeśli go Państwo zmodyfikują i udostępnią innym przez sieć, dzielą się Państwo swoimi zmianami.
  2. Proszę zainstalować go przez Docker Compose: obraz typu wszystko w jednym ghcr.io/bluewave-labs/checkmate i MongoDB 8.0, z portem opublikowanym na 127.0.0.1 za odwrotnym proxy z HTTPS.
  3. Proszę ustawić JWT_SECRET, ENCRYPTION_KEY i swój publiczny adres w CLIENT_HOST oraz dodać NODE_ENV=production, którego plik referencyjny nie zawiera.
  4. Pierwsza osoba, która się zarejestruje, zostaje Superadminem: proszę utworzyć swoje konto zaraz po pierwszym uruchomieniu, a wszyscy pozostali dołączają przez zaproszenie.
  5. Proszę kopiować bazę MongoDB poleceniem mongodump i zachować swój plik .env, a aktualizować przez zmianę tagu obrazu: migracje uruchamiają się same przy starcie.

Co robi Checkmate

Checkmate sprawdza Państwa usługi w regularnych odstępach, zapisuje każdą odpowiedź i jej czas, a gdy coś przestaje odpowiadać, wysyła alert. Jego twórca, BlueWave Labs, opisuje go jako samodzielnie hostowane narzędzie do śledzenia w czasie rzeczywistym sprzętu serwerów, dostępności, czasów odpowiedzi i incydentów.

Na co pozwala licencja AGPL-3.0

Checkmate jest udostępniany na licencji GNU Affero General Public License, wersja 3 (AGPL-3.0). Mogą Państwo używać go bezpłatnie, dla siebie, swojej firmy lub klientów, kopiować go i modyfikować.

Jej szczególna klauzula dotyczy użycia przez sieć: jeśli zmodyfikują Państwo Checkmate i pozwolą innym osobom korzystać ze zmodyfikowanej wersji przez sieć, muszą Państwo udostępnić im jej kod źródłowy. Uruchomienie oficjalnego obrazu bez zmian, jak w tym poradniku, nie rodzi takiego obowiązku. Oprogramowanie jest dostarczane bez gwarancji.

Zasoby do zaplanowania

Dokumentacja ustala skromne minimum: dowolny VPS z Linuksem z 1 GB RAM lub więcej. Dodaje, że MongoDB zużywa około 400 MB na instancji, która co minutę sprawdza ponad 300 serwerów.

Rozmiar serwera zależy więc od liczby monitorów, ich interwału i przechowywanej historii. Na Managed VPS wystarczy opisać nam swoje zastosowanie, a polecimy odpowiedni rozmiar.

Instalacja przez Docker Compose

Od wersji 3.10 Checkmate jest dostarczany jako jeden obraz, ghcr.io/bluewave-labs/checkmate, który obsługuje zarówno interfejs, jak i API. MongoDB działa obok, we własnym kontenerze. Na serwerze z Docker Engine i jego wtyczką Compose, zainstalowanymi z repozytorium Dockera dla Ubuntu, proszę utworzyć katalog, na przykład /opt/checkmate, i umieścić w nim ten compose.yaml, oparty na pliku referencyjnym 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 sekrety trafiają do pliku .env obok, który Docker Compose odczytuje sam. Proszę utworzyć go z prawem odczytu wyłącznie dla roota, a następnie uruchomić stos:

Terminal, w /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

Pierwsze uruchomienie wykonuje migracje bazy danych; na naszym testowym VPS aplikacja zgłosiła dobry stan w niecałe dziesięć sekund. Aby sprawdzić, czy odpowiada:

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

Pierwsze polecenie odpowiada 200. Drugie odpowiada "data":false, dopóki nie istnieje żadne konto, i true, gdy Superadmin zostanie utworzony.

Pierwsze konto, role i zaproszenia

Checkmate nie ma konta domyślnego. Pierwsza osoba, która się zarejestruje, zostaje Superadminem, dlatego proszę utworzyć swoje konto zaraz po pierwszym uruchomieniu, zanim otworzą Państwo adres dla publiczności. Tunel SSH przenosi port 52345 serwera na Państwa komputer, pod adres http://localhost:52345; proszę dodać -p i port SSH podany w Państwa strefie klienta.

Terminal, na Państwa komputerze
ssh -L 52345:127.0.0.1:52345 root@status.example.com
  1. Proszę otworzyć http://localhost:52345: Checkmate wyświetla swoją stronę rejestracji.
  2. Proszę podać imię, nazwisko, adres e-mail i hasło o długości co najmniej 8 znaków, z wielką literą, małą literą, cyfrą i znakiem specjalnym.
  3. Proszę się zarejestrować: trafiają Państwo na pulpit, zalogowani jako Superadmin.

Od tej chwili publiczna rejestracja jest zamknięta: na naszym testowym VPS każdy nowy odwiedzający był kierowany na stronę logowania, a adres rejestracji również do niej prowadził. Inne osoby dołączają przez zaproszenie, z sekcji Team w ustawieniach konta, z rolą User lub Admin. Zaproszenie wychodzi e-mailem, więc wymaga opisanych niżej ustawień SMTP, a jego link wygasa po godzinie.

RolaCo może robić
UserWidzieć wszystkie monitory, pulpit, kontrole, incydenty, strony statusu i ustawienia, bez zmieniania czegokolwiek
AdminWszystko, co User, a do tego monitory, kanały powiadomień, incydenty, okna serwisowe, strony statusu, zaproszenia i ustawienia globalne, w tym SMTP
SuperadminWszystko, co Admin, a do tego bezpośrednie tworzenie kont, edycja innego użytkownika, zmiana roli lub hasła

Od v4.0.0 tagi, strony statusu i proxy to działania Admina: User, który wcześniej mógł nimi zarządzać, traci ten dostęp po aktualizacji.

HTTPS: odwrotne proxy

Kontener udostępnia Checkmate przez HTTP, na porcie 52345. HTTPS obsługuje odwrotne proxy umieszczone przed nim: dokumentacja wymienia Caddy, Traefik i nginx. Przetestowaliśmy Caddy, zainstalowany z jego oficjalnego repozytorium dla Debiana i Ubuntu: sam uzyskuje certyfikat Let’s Encrypt, odnawia go i domyślnie przekazuje nagłówek Host oraz nagłówki X-Forwarded-*.

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

Pierwszy monitor i jego alerty

  1. W „Uptime” proszę kliknąć „Create monitor” i wybrać HTTP/HTTPS.
  2. Proszę podać adres do sprawdzania, nazwę, którą rozpoznają Państwo w alercie, i interwał: dokumentacja zaleca od jednej do pięciu minut dla usługi krytycznej.
  3. Proszę zapisać: Checkmate od razu wykonuje pierwszą kontrolę. Na naszym testowym VPS monitor zgłaszał dostępność minutę później.

E-mail: ustawienia SMTP

Alerty e-mail i zaproszenia przechodzą przez połączenie SMTP wspólne dla całego serwera, ustawiane w „Settings”, zakładka „Email”: host, port, użytkownik, hasło i adres nadawcy, a następnie „Save” i „Test”. Na VPS Simafri proszę użyć uwierzytelnianego serwera SMTP na porcie 587 lub 465: usługi poczty Państwa domeny albo usługi wysyłkowej. Następnie proszę utworzyć powiadomienie e-mail z adresami do powiadamiania i przypiąć je do swoich monitorów.

Slack, Discord, Teams, Telegram i pozostałe kanały tworzy się w ten sam sposób, w „Notifications”, każdy z adresem webhooka lub tokenem i każdy z przyciskiem „Test”.

Monitory heartbeat dla zaplanowanych zadań

Monitor heartbeat nadzoruje zadanie, które uruchamia się samo, takie jak nocna kopia zapasowa. Proszę wygenerować klucz ping zespołu w „Settings”, zakładka „Monitoring” (jest wyświetlany tylko raz), utworzyć monitor Heartbeat ze slugiem i oknem alertu, a następnie wywołać jego adres ping na końcu zadania:

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"

Dodanie do adresu /fail lub kodu wyjścia zadania od razu oznacza monitor jako niedostępny, bez czekania na upływ okna.

Strony statusu

W „Status pages” Admin publikuje stronę, która wymienia wybrane monitory i ich dostępność, dla Państwa klientów lub zespołu. Od v4.0.0 każda strona statusu ma strefę czasową, domyślnie UTC.

Kopie zapasowe

Wszystko znajduje się w dwóch miejscach: w bazie MongoDB, w wolumenie mongo-data, oraz w Państwa pliku .env. Ten drugi proszę przechowywać w bezpiecznym miejscu: ENCRYPTION_KEY jest potrzebny do odczytu sekretów zapisanych w bazie, a JWT_SECRET utrzymuje zalogowanie Państwa użytkowników. Obraz MongoDB zawiera mongodump:

Terminal, w /opt/checkmate
docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db > checkmate-$(date +%F).archive.gz
cp .env env-$(date +%F).bak

Proszę zaplanować tę kopię i wysyłać ją poza serwer; monitor heartbeat może Państwa powiadomić, gdyby kiedyś przestała się wykonywać. Umieszczone na dysku, archiwa trafiają także do nocnych kopii zapasowych serwera.

Przywracanie

Na tej samej lub nowej instalacji, z tym samym .env, proszę zatrzymać aplikację, wczytać archiwum, a następnie ponownie ją uruchomić:

Terminal, w /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

Przetestowaliśmy cały cykl na naszym VPS: kopia, rzeczywiste usunięcie bazy danych, przywrócenie. Monitor i konto wróciły, a logowanie od razu znów działało.

Checkmate v4.0.0 oferuje też szyfrowane kopie w chmurze przez Checkmate Connect, opcjonalną usługę, bezpłatną w okresie beta, która wymaga ENCRYPTION_KEY i Superadmina do zarejestrowania instalacji. Powyższe kopie działają bez niej.

Aktualizacje

Proszę przeczytać informacje o wydaniu, wykonać kopię zapasową, zmienić tag obrazu w compose.yaml, a następnie pobrać nowy obraz i odtworzyć kontener. Migracje bazy danych uruchamiają się same przy starcie:

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

Telemetria

Checkmate wysyła jeden anonimowy raport dziennie: identyfikator instalacji, wersję, sposób instalacji i liczbę monitorów każdego typu, bez Państwa adresów i wyników. Informuje o tym w dzienniku przy starcie. Aby ją wyłączyć, proszę dodać TELEMETRY_ENABLED=false do środowiska usługi checkmate, a następnie uruchomić docker compose up -d.

Kto za co odpowiada na Managed VPS

Samodzielny hosting wymaga prowadzenia serwera, oprócz samej aplikacji. Na Managed VPS nasze zespoły przejmują serwer i proaktywnie czuwają nad Państwa instancją; Checkmate pozostaje Państwa oprogramowaniem, z jego monitorami i Państwa ustawieniami.

TematNasze zespołyPaństwo
SerwerAktualizacje systemu i zabezpieczeń, w tym interwencje na serwerzeMoment dogodny dla Państwa działalności
NadzórSerwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefonPaństwa własne monitory, alerty i strony statusu w Checkmate
CheckmateProaktywna opieka: wychwytujemy błędy, spowolnienia, stan bazy danych i brak miejsca na dysku oraz polecamy poprawkęInstalacja, aktualizacje i ustawienia, które wdrażają Państwo sami albo Państwa asystent AI
Użytkownicy i alertySerwer, który ich obsługuje, nadzorowany i objęty kopiami zapasowymiKonta, role, zaproszenia i kanały powiadomień
Kopie zapasoweCo noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenieEksporty bazy danych właściwe dla Checkmate oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne
MigracjaMigracja Państwa obecnego serwera, bezpłatnaMoment przełączenia

Jeśli wolą Państwo, aby nasze zespoły interweniowały w samej aplikacji, usługa ta jest rozliczana godzinowo lub ryczałtowo, z wyceną przekazaną przed interwencją.

Checkmate na serwerze prowadzonym za Państwa

Z Managed VPS od Simafri nasze zespoły utrzymują serwer Państwa instancji Checkmate w aktualności, nadzorują go dniem i nocą i interweniują bez czekania na Państwa telefon; proaktywnie czuwają także nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami albo Państwa asystent AI. Kopie zapasowe są szyfrowane co noc i przechowywane poza maszyną, ich przywracanie jest w cenie, a migracja obecnego serwera jest bezpłatna.

Poznaj Managed VPS

Częste pytania

Czy Checkmate jest bezpłatny?

Tak. Checkmate jest udostępniany na licencji AGPL-3.0: mogą Państwo uruchamiać go dla siebie, swojego zespołu lub klientów bez zakupu licencji. Jeśli go Państwo zmodyfikują i udostępnią innym przez sieć, dzielą się Państwo swoimi zmianami. Pozostaje koszt serwera, na którym działa.

Jak zainstalować Checkmate przez Docker Compose?

Proszę użyć referencyjnego compose.yaml: obrazu ghcr.io/bluewave-labs/checkmate i MongoDB 8.0. Proszę umieścić JWT_SECRET i ENCRYPTION_KEY w pliku .env, ustawić CLIENT_HOST na swój adres https i NODE_ENV na production, opublikować port 52345 na 127.0.0.1, uruchomić docker compose up -d i postawić przed nim odwrotne proxy z HTTPS.

Jakie są domyślne dane logowania Checkmate?

Takich danych nie ma. Pierwsza osoba, która zarejestruje się na nowej instancji, zostaje Superadminem. Proszę utworzyć swoje konto zaraz po pierwszym uruchomieniu, przez tunel SSH; potem odwiedzający są kierowani na stronę logowania, a nowi użytkownicy dołączają przez zaproszenie.

Ile pamięci potrzebuje Checkmate?

Dokumentacja wymaga VPS z Linuksem z 1 GB RAM lub więcej. Na naszym testowym VPS świeża instalacja zużywała około 300 MB dla Checkmate i 280 MB dla MongoDB. Dysk rośnie wraz z liczbą monitorów, ich interwałem i przechowywaną historią, domyślnie 90 dni.

Jak wysyłać alerty Checkmate e-mailem?

Proszę ustawić połączenie SMTP w Settings, zakładka Email: host, port 587 lub 465, użytkownik, hasło i nadawca, a następnie Save i Test. Proszę utworzyć powiadomienie e-mail z adresami do powiadamiania i przypiąć je do swoich monitorów. Zaproszenia korzystają z tych samych ustawień.

Jak wykonać kopię zapasową Checkmate?

Proszę wyeksportować bazę MongoDB poleceniem docker compose exec -T mongodb mongodump --archive --gzip --db uptime_db i zachować kopię pliku .env, którego ENCRYPTION_KEY jest potrzebny do odczytu zapisanych sekretów. Przywraca się ją poleceniem mongorestore --archive --gzip --drop, przy zatrzymanej aplikacji.

Jak zaktualizować Checkmate?

Proszę przeczytać informacje o wydaniu i wykonać kopię zapasową, zmienić tag obrazu w compose.yaml, a następnie uruchomić docker compose pull i docker compose up -d. Migracje bazy danych uruchamiają się same przy starcie.

Czy Managed VPS obejmuje Checkmate?

Managed VPS obejmuje serwer: system, bezpieczeństwo, nadzór i kopie zapasowe. Nasze zespoły proaktywnie czuwają też nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami. Interwencja w aplikacji jest rozliczana godzinowo lub ryczałtowo.

Źródła i oficjalna dokumentacja

Powiązane poradniki

Hosting Uptime Kuma na Managed VPS: Państwa usługi pod stałym nadzoremHosting Uptime Kuma na Managed VPS oznacza, że Państwa strony, API i serwery są monitorowane z maszyny, która należy do Państwa, a nasze zespoły dbają o jej aktualność i nadzorują ją dniem i nocą. Uptime Kuma to wolne oprogramowanie na licencji MIT. Ten poradnik podąża za jego oficjalną dokumentacją: instalacja przez Docker Compose, HTTPS, baza danych, powiadomienia, kopie zapasowe i aktualizacje.Kopie zapasowe VPS: co sprawdzić przed podpisaniem umowyOferta VPS prawie zawsze zapowiada „kopie zapasowe w cenie”. Za tymi słowami może kryć się kopia wykonywana co noc, przechowywana poza maszyną i przywracana przez ekspertów, albo migawka zapisana na tym samym dysku co serwer. Ten poradnik podaje pytania, które robią różnicę, wyjaśnia, co oznacza każda odpowiedź, i pokazuje, jak sprawdzić, czy kopię da się przywrócić.Różnica między VPS zarządzanym a niezarządzanym: kto co robiRóżnica między VPS zarządzanym a niezarządzanym sprowadza się do jednego pytania: kto zajmuje się serwerem, gdy już działa. Samo słowo „zarządzany” nie ma przy tym oficjalnej definicji: u różnych firm hostingowych oznacza wszystko, od samej instalacji systemu po pełne prowadzenie serwera. Ten poradnik pokazuje, kto co robi, punkt po punkcie, łącznie z pośrednim poziomem, jakim jest wsparcie, i podaje pytania, które rozwiewają wątpliwości przed podpisaniem umowy.
Skontaktuj się z nami