Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

MONITORING / DOCKER

Uptime Kuma: prywatny monitoring w Docker Compose

Gotowy Compose z trwałym wolumenem, SQLite i panelem przez tunel SSH. Instrukcja pierwszego monitora, kopii danych i aktualizacji.

Środowisko i zakresNowa, prywatna instalacja na Linuxie z Docker Engine 28+ i Compose v2+. Panel jest dostępny przez loopback hosta; paczka nie konfiguruje publicznej domeny.

Co dostajesz?

Compose z przypiętym digestem obrazu Uptime Kuma 2, jawnym wyborem SQLite, wolumenem /app/data i rotacją logów. Plik .env.example pozwala zmienić lokalny port. README opisuje uruchomienie, kopię danych oraz wycofanie.

1. Uruchom w osobnym katalogu

Rozpakuj ZIP na VPS-ie i przejdź do katalogu uptime-kuma. Nazwa moj-monitoring musi być wolna i pozostać taka sama we wszystkich poleceniach. Jeśli port 3001 jest zajęty, zmień KUMA_PORT w .env.

cp .env.example .env
docker compose -p moj-monitoring config --quiet
docker compose -p moj-monitoring up -d
docker compose -p moj-monitoring ps

2. Otwórz panel przez SSH

Na swoim komputerze uruchom tunel, podstawiając użytkownika i adres VPS-a. Następnie otwórz http://localhost:13001, utwórz administratora i włącz 2FA. Zmiana KUMA_PORT wymaga także zmiany docelowego portu tunelu.

ssh -N -L 13001:127.0.0.1:3001 uzytkownik@twoj-vps

3. Dodaj i sprawdź monitor

Dodaj monitor HTTP swojej strony, np. z interwałem 60 sekund. Najpierw potwierdź odpowiedź prawidłowego adresu, potem dodaj osobny testowy adres zwracający 404 i sprawdź zmianę stanu. Własny kanał powiadomień skonfiguruj i przetestuj oddzielnie.

Uwaga: Monitoring na tym samym VPS-ie nie wyśle alertu po całkowitym wyłączeniu hosta. Do takiej kontroli potrzebny jest niezależny punkt monitorujący.

4. Zachowaj dane i możliwość powrotu

Wolumen moj-monitoring_kuma-data przechowuje bazę i ustawienia. W README znajdziesz archiwizację przy zatrzymanej usłudze. Przechowuj zaszyfrowaną kopię poza VPS-em i sprawdź odtworzenie na osobnym wolumenie przed aktualizacją.

Zwykłe down usuwa kontener i sieć, zachowując wolumen. Nie dodawaj -v do wycofania, jeśli dane mają pozostać.

docker compose -p moj-monitoring down

Co sprawdziliśmy?

29.09.2026 sprawdzono parsowanie Compose, start HTTP, inicjalizację SQLite, mapowanie portu na 127.0.0.1 i zachowanie pliku kontrolnego po odtworzeniu kontenera. Nie testowano zewnętrznych dostawców powiadomień ani długotrwałego obciążenia.

PLIKI / WERSJA 1

Pobierz i sprawdź u siebie

ZIP zawiera instrukcję README.md i pliki wymienione poniżej.

Pobierz ZIP (2,0 KiB) ↓
Zawartość i suma SHA-256
  • .env.example
  • README.md
  • compose.yaml

b9af300fc99abf470fa6e4270603e7ad28111b8e26173fd137e9a0572ffb6d9d

Źródła i dokumentacja

Data publikacji: 29.09.2026.