Hosting Uptime Kuma na Managed VPS: Państwa usługi pod stałym nadzorem

Co monitoruje Uptime Kuma

Uptime Kuma w regularnych odstępach, nawet co 20 sekund, odpytuje Państwa usługi, przechowuje historię ich odpowiedzi i powiadamia Państwa, gdy któraś przestaje odpowiadać. Obsługuje się go z poziomu interfejsu webowego, dostępnego w wielu językach.

• Sondy: HTTP i HTTPS, wyszukiwanie słowa kluczowego na stronie, zapytanie JSON, TCP, WebSocket, ping, rekord DNS, kontenery Docker oraz sonda „push” dla zadania cyklicznego, które samo zgłasza swoje uruchomienie.
• Alerty: ponad 90 usług powiadomień, między innymi Telegram, Discord, Slack i e-mail.
• Strony statusu: kilka stron publicznych, każda w razie potrzeby na własnej domenie.
• Certyfikaty: informacje o certyfikacie HTTPS każdej monitorowanej usługi.
• Konto: uwierzytelnianie dwuskładnikowe oraz użycie proxy dla sond, które tego wymagają.

Uptime Kuma proszę umieścić na innym serwerze niż usługi, które monitoruje. Na osobnej maszynie widzi awarię z zewnątrz i wysyła alert, gdy Państwa usługi są wyłączone.

Na co pozwala licencja MIT

Uptime Kuma jest udostępniany na licencji MIT. Zezwala ona na używanie, kopiowanie, modyfikowanie, łączenie, publikowanie, rozpowszechnianie, sublicencjonowanie i sprzedaż oprogramowania, pod jednym warunkiem: w każdej kopii musi pozostać informacja o prawach autorskich i tekst licencji.

Mogą więc Państwo uruchomić Uptime Kuma w firmie, monitorować w nim usługi swoich klientów i udostępniać im strony statusu, bez zakupu licencji.

Instalacja przez Docker Compose

Dokumentacja Uptime Kuma zaczyna od Docker Compose. Na serwerze z zainstalowanym Dockerem proszę utworzyć katalog i pobrać oficjalny plik:

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml

Plik projektu publikuje port 3001 na wszystkich adresach serwera. Za odwrotnym proxy proszę ograniczyć go do adresu lokalnego, jak proponuje README:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "127.0.0.1:3001:3001"

docker compose up -d

• Port opublikowany na 127.0.0.1: Docker domyślnie publikuje porty na wszystkich adresach serwera, przed regułami zapory ufw. Lokalnie Uptime Kuma jest osiągalny wyłącznie przez odwrotne proxy.
• Katalog data na dysku lokalnym: zawiera bazę kuma.db, przesłane pliki i zrzuty ekranu. Projekt odradza NFS i inne sieciowe systemy plików, ponieważ SQLite potrzebuje niezawodnych blokad plików.
• Tag 2 podąża za wersją 2 Uptime Kuma, a przejście na kolejną wersję główną pozostaje Państwa decyzją.
• Obraz 2-slim jest lżejszy, do pobrania około 185 MB wobec 620 MB: pomija Chromium i wbudowaną MariaDB, które zawiera obraz 2. To obraz 2 jest polecany przez projekt, a sonda „Browser Engine” wymaga przy 2-slim zewnętrznego Chromium.

Przy pierwszym uruchomieniu proszę otworzyć interfejs: kreator prosi o wybór bazy danych, a potem o utworzenie konta administratora. Uwierzytelnianie dwuskładnikowe proszę włączyć od pierwszego logowania.

Projekt nie podaje wymagań dotyczących pamięci ani procesora: rozmiar zależy od liczby monitorowanych usług i pożądanej częstotliwości. Na Managed VPS wystarczy opisać nam swoje zastosowanie, a polecimy odpowiedni rozmiar.

HTTPS i WebSocket: odwrotne proxy

W sieci publicznej projekt wymaga HTTPS. Uptime Kuma opiera się na WebSocket: odwrotne proxy musi przekazywać nagłówki Upgrade i Connection. Działa w katalogu głównym domeny lub subdomeny, a jego wiki odradza podkatalogi, takie jak example.com/uptimekuma.

Z Caddy

Caddy samodzielnie uzyskuje i odnawia certyfikat oraz przekazuje WebSocket bez dodatkowej konfiguracji:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

Z Nginx i Certbotem

server {
    listen 80;
    server_name uptime.example.com;

    location / {
        proxy_pass         http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
        proxy_set_header   Host $host;
    }
}

Certbot następnie instaluje certyfikat Let’s Encrypt oraz przekierowanie na HTTPS, a potem sam go odnawia:

sudo certbot --nginx -d uptime.example.com

Gdy Uptime Kuma jest osiągalny wyłącznie przez proxy, proszę otworzyć jego ustawienia, „Settings”, „Reverse Proxy”, „HTTP Headers”, i ustawić „Trust Proxy” na „Yes”: w dziennikach pojawią się wtedy rzeczywiste adresy odwiedzających.

SQLite czy MariaDB

Od wersji 2 Uptime Kuma oferuje trzy bazy danych do wyboru w kreatorze pierwszego uruchomienia:

Aby ustalić wybór z góry, z pominięciem kreatora, zmienne UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME i UPTIME_KUMA_DB_PASSWORD dodaje się do usługi w compose.yaml.

Powiadomienia, także e-mail

Sonda ma sens tylko wtedy, gdy alert do Państwa dociera. Kanały proszę zadeklarować w „Settings”, „Notifications”, wysłać z każdego wiadomość próbną i przewidzieć dwa, na przykład komunikator i e-mail: gdy jeden zawiedzie, drugi go zastąpi.

W przypadku e-maila Uptime Kuma łączy się z serwerem SMTP. Na VPS Simafri wysyłka odbywa się przez uwierzytelniony przekaźnik na porcie 587: adres posiadanego już konta pocztowego albo Simafri Suite.

Kopie zapasowe i aktualizacje

Od wersji 2 kopia katalogu data jest jedyną metodą obsługiwaną przez projekt. Przy SQLite lub wbudowanej MariaDB mieści się tam wszystko. Baza SQLite skopiowana w trakcie zapisu może zostać uszkodzona: na czas kopiowania proszę zatrzymać kontener, pamiętając, że sondy zatrzymują się razem z nim.

docker compose stop
tar -czf uptime-kuma-$(date +%F).tar.gz data
docker compose start

Aktualizacja

Wiki projektu podaje dwa polecenia, wydawane z katalogu z compose.yaml. Katalog data pozostaje na miejscu:

docker compose pull
docker compose up -d --force-recreate

Przed każdą aktualizacją proszę przeczytać informacje o wydaniu: niektóre zawierają poprawki bezpieczeństwa, jak wersja 2.5.9 z 31 października 2026 roku. Kopia wykonana tuż przed aktualizacją daje prosty powrót do poprzedniego stanu.

Przejście z wersji 1 na wersję 2 wymaga większej staranności: proszę skopiować katalog data przy zatrzymanym kontenerze i pozwolić migracji dojść do końca, ponieważ przerwana migracja wymaga przywrócenia kopii. Projekt odnotował około 7 minut dla 20 sond i 90 dni historii, a znacznie więcej na skromnej maszynie lub przy większej liczbie sond.

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ą; Uptime Kuma pozostaje Państwa oprogramowaniem, z Państwa ustawieniami i danymi.

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