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.
Autor: Simon Vasconcelos Lee
Opublikowano 17 listopada 2026Czas czytania: 12 minut
ghcr.io/bluewave-labs/checkmate i MongoDB 8.0, z portem opublikowanym na 127.0.0.1 za odwrotnym proxy z HTTPS.JWT_SECRET, ENCRYPTION_KEY i swój publiczny adres w CLIENT_HOST oraz dodać NODE_ENV=production, którego plik referencyjny nie zawiera.mongodump i zachować swój plik .env, a aktualizować przez zmianę tagu obrazu: migracje uruchamiają się same przy starcie.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.
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.
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.
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:
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:
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: plik referencyjny publikuje go bez adresu, a Docker otwiera go wtedy na wszystkich adresach serwera. Opublikowany lokalnie, jest osiągalny wyłącznie przez odwrotne proxy.CLIENT_HOST to adres, który wpisują Państwa użytkownicy, z https://. Checkmate używa go do kontroli żądań z innych domen (cross-origin) oraz w linkach w swoich alertach i e-mailach.NODE_ENV=production: README wymaga go we wdrożeniach produkcyjnych. Bez niego aplikacja działa w trybie deweloperskim, który wyłącza ogranicznik liczby żądań API.ENCRYPTION_KEY jest w pliku referencyjnym opcjonalny. Szyfruje sekrety przechowywane przez Checkmate, a v4.0.0 wymaga go dla monitorów Docker z TLS i dla Checkmate Connect. Proszę ustawić go od początku: to prostsze niż dodawanie go później.latest i pobiera go przy każdym starcie. Pełna wersja, tutaj v4.0.0, pozwala Państwu wybrać moment każdej aktualizacji.mongo-data przechowuje wszystkie Państwa dane: monitory, kontrole, użytkowników i ustawienia.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:
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.
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.
ssh -L 52345:127.0.0.1:52345 root@status.example.com
http://localhost:52345: Checkmate wyświetla swoją stronę rejestracji.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.
| Rola | Co może robić |
|---|---|
| User | Widzieć wszystkie monitory, pulpit, kontrole, incydenty, strony statusu i ustawienia, bez zmieniania czegokolwiek |
| Admin | Wszystko, co User, a do tego monitory, kanały powiadomień, incydenty, okna serwisowe, strony statusu, zaproszenia i ustawienia globalne, w tym SMTP |
| Superadmin | Wszystko, 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.
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-*.
status.example.com {
reverse_proxy 127.0.0.1:52345
}
sudo systemctl reload caddy
CLIENT_HOST musi zawierać ten sam adres https:// co proxy. Po jego zmianie proszę uruchomić docker compose up -d, aby odtworzyć kontener.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”.
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:
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.
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.
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:
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.
Na tej samej lub nowej instalacji, z tym samym .env, proszę zatrzymać aplikację, wczytać archiwum, a następnie ponownie ją uruchomić:
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.
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:
docker compose pull
docker compose up -d
docker compose logs checkmate | grep -i migration
mongodump i mongorestore. Żadna nowa zmienna środowiskowa nie jest wymagana.checkmate-client, checkmate-backend i checkmate-mongo, które nie są już aktualizowane. Proszę przejść na ghcr.io/bluewave-labs/checkmate i zachować usługę MongoDB oraz jej wolumen; zmienne UPTIME_APP_* nie są już odczytywane.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.
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.
| Temat | Nasze zespoły | Państwo |
|---|---|---|
| Serwer | Aktualizacje systemu i zabezpieczeń, w tym interwencje na serwerze | Moment dogodny dla Państwa działalności |
| Nadzór | Serwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefon | Państwa własne monitory, alerty i strony statusu w Checkmate |
| Checkmate | Proaktywna 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 alerty | Serwer, który ich obsługuje, nadzorowany i objęty kopiami zapasowymi | Konta, role, zaproszenia i kanały powiadomień |
| Kopie zapasowe | Co noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenie | Eksporty bazy danych właściwe dla Checkmate oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne |
| Migracja | Migracja Państwa obecnego serwera, bezpłatna | Moment 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ą.
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.
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.
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.
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.
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.
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ń.
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.
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.
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.
Simafri
Porozmawiajmy o Państwa projekcie
Proszę powiedzieć nam w kilku słowach, czego Państwo potrzebują: odpowiemy szybko.
Dziękujemy! Państwa zapytanie zostało wysłane. Wkrótce się odezwiemy.
Wolą Państwo e-mail? Proszę napisać do nas na support@simafri.com.