Co to jest Uptime Kuma? Kompletny przewodnik po monitoringu

Podstawy i pierwsze kroki

Co to jest Uptime Kuma?
Kompletny przewodnik po open-source'owym monitoringu

Marzec 2026 | Czas czytania: ~16 min

Czym jest Uptime Kuma i dlaczego warto ją znać

Uptime Kuma to darmowe, open-source'owe narzędzie do monitorowania dostępności stron internetowych, serwerów, API i usług sieciowych. Stworzone przez hongkońskiego programistę Louisa Lama i wydane na licencji MIT, Uptime Kuma szybko stało się jednym z najpopularniejszych projektów self-hosted w historii GitHuba — gromadząc ponad 84 000 gwiazdek i zyskując zaufanie setek tysięcy administratorów IT na całym świecie.

Nazwa „Kuma" pochodzi od japońskiego słowa oznaczającego niedźwiedzia — stąd urocza maskotka projektu. Ale za przyjazną estetyką kryje się potężne narzędzie monitoringu, które oferuje ponad 30 typów monitorów, 91 natywnych kanałów powiadomień, konfigurowalne strony statusu i integrację z ekosystemem DevOps — wszystko to bez żadnych opłat licencyjnych.

W dobie, gdy minuta przestoju (downtime) kosztuje firmy średnio 5 600 dolarów według raportu Gartnera, a badania pokazują że 98% przedsiębiorstw traci ponad 100 000 dolarów za każdą godzinę niedostępności, monitoring usług internetowych przestał być luksusem — stał się fundamentalną koniecznością. Uptime Kuma wypełnia lukę między drogimi rozwiązaniami enterprise (Datadog, New Relic, PagerDuty) a prostymi, ograniczonymi narzędziami online (Uptime Robot w darmowym planie), oferując profesjonalny monitoring bez barier wejścia i bez limitów na liczbę monitorowanych usług.

Co wyróżnia Uptime Kuma na tle konkurencji? Przede wszystkim połączenie prostoty z rozbudowaną funkcjonalnością. Instalacja trwa dosłownie 5 minut (jedna komenda Docker), interfejs jest intuicyjny i nie wymaga szkolenia, a jednocześnie pod spodem kryje się narzędzie zdolne monitorować wszystko — od prostej strony HTML po klastry Kafka, bazy Oracle i serwery gier Minecraft. To rzadkie połączenie w świecie narzędzi monitoringu, gdzie zazwyczaj prostota oznacza ograniczenia, a zaawansowane funkcje — strome krzywe uczenia.

Informacja

Uptime Kuma jest projektem open-source na licencji MIT — możesz ją używać, modyfikować i dystrybuować bez ograniczeń, zarówno w celach prywatnych, jak i komercyjnych. Kod źródłowy jest dostępny na GitHubie. Projekt jest aktywnie rozwijany — ostatni commit pochodzi z ostatnich dni, a nowe wersje ukazują się regularnie.

Geneza i popularność — od projektu hobbystycznego do 84K gwiazdek

Uptime Kuma została opublikowana na GitHubie w sierpniu 2021 roku przez Louisa Lama, programistę z Hongkongu specjalizującego się w Node.js i Dockerze. Projekt powstał z prostej, osobistej potrzeby — Louis chciał mieć lekkie, self-hosted narzędzie do monitorowania swoich usług, które nie wymagałoby skomplikowanej infrastruktury, zewnętrznych baz danych ani kosztownych subskrypcji. Istniejące rozwiązania albo były zbyt skomplikowane (Zabbix, Nagios), albo zbyt ograniczone w darmowych planach (Uptime Robot), albo wymagały całego stosu technologicznego (Prometheus + Alertmanager + Grafana).

W ciągu zaledwie kilku miesięcy projekt eksplodował popularnością w społecznościach self-hosted i homelabowych na Reddicie, Hacker News i w forach Dockera. Kluczowe kamienie milowe projektu:

  • Sierpień 2021 — pierwsza publiczna wersja na GitHubie
  • Październik 2021 — 8 000 gwiazdek, projekt trafia na front page Hacker News
  • 2022 — przekroczenie 20 000 gwiazdek, dodanie push monitorów i Docker container monitoring
  • 2023 — 30 000+ gwiazdek, integracja z Prometheus, rozbudowa kanałów powiadomień do 70+
  • 2024 — 50 000+ gwiazdek, GameDig (monitoring 320+ serwerów gier), maintenance windows, 80+ notification providers
  • Październik 2025wersja 2.0: przełomowa aktualizacja z obsługą MariaDB/MySQL, całkowicie przepisany UI (Vue 3 + Vite), rootless Docker image, nowe typy monitorów
  • Luty 2026wersja 2.1: Globalping (rozproszone sondy z całego świata), domain expiry monitoring (RDAP), Jira Service Management, HaloPSA, Google Sheets
  • Marzec 2026 — ponad 84 000 gwiazdek i 100 milionów pobrań z Docker Hub

Pod względem popularności na GitHubie, Uptime Kuma jest najpopularniejszym narzędziem do monitorowania uptime w kategorii self-hosted — wyprzedzając projekty takie jak Gatus (10K stars), Statping-ng (8K stars) czy Cachet (14K stars). W kategoriach ogólnego monitoringu ustępuje jedynie znacznie starszym i szerszym w zakresie projektom: Prometheus (57K stars) i Grafana (68K stars), które jednak pełnią inną rolę — są platformami metryk i wizualizacji, nie dedykowanymi narzędziami uptime monitoring.

Wzrost popularności Uptime Kuma dodatkowo przyspieszyła zmiana polityki cenowej Uptime Robot w październiku 2024, kiedy to darmowy plan został ograniczony wyłącznie do użytku niekomercyjnego. Tysiące użytkowników komercyjnych zaczęło szukać alternatyw — i Uptime Kuma okazała się naturalnym wyborem: darmowa, bez ograniczeń, z większą liczbą typów monitorów i kanałów powiadomień niż płatne plany konkurencji.

Jak działa Uptime Kuma — architektura i technologie

Uptime Kuma to aplikacja webowa zbudowana na nowoczesnym stosie technologicznym, zaprojektowanym z myślą o lekkości, szybkości i prostocie wdrożenia:

  • Backend: Node.js z Socket.IO dla komunikacji w czasie rzeczywistym (WebSocket)
  • Frontend: Vue 3 + Vite — szybki, reaktywny interfejs SPA (Single Page Application)
  • Baza danych: SQLite (domyślnie, zero konfiguracji) lub MariaDB/MySQL (od wersji 2.0, dla większych wdrożeń)
  • ORM: RedBeanNode — lekki ORM dla Node.js
  • Szablony powiadomień: LiquidJS z ochroną przed SSTI
  • Konteneryzacja: oficjalny obraz Docker na Docker Hub (louislam/uptime-kuma:2)

Cała aplikacja działa jako pojedynczy proces Node.js — nie wymaga osobnego serwera bazy danych (gdy używasz SQLite), serwera kolejek ani workera w tle. To jedna z kluczowych zalet: prostota wdrożenia. Jeden kontener Docker, jeden wolumen danych — i masz pełnoprawną platformę monitoringu.

Jak przebiega proces monitorowania

Cykl monitorowania w Uptime Kuma jest prosty, ale skuteczny i wielostopniowy:

1

Konfiguracja monitora

Definiujesz typ monitora (np. HTTP, Ping, DNS, Docker), podajesz adres URL lub IP, ustawiasz interwał sprawdzania (od 20 sekund do 24 dni) oraz liczbę prób (max retries) przed oznaczeniem usługi jako niedostępnej. Możesz też skonfigurować timeout, accepted status codes, custom headers, body request, autentykację (Basic, OAuth2, mTLS, NTLM) i wiele więcej.

2

Cykliczne sprawdzanie

Uptime Kuma wykonuje zapytania do monitorowanych usług w ustalonych interwałach. Mierzy czas odpowiedzi (response time w milisekundach), sprawdza kody statusu HTTP, waliduje certyfikaty SSL, porównuje odpowiedzi z oczekiwanymi wartościami (keyword, JSON query) i zapisuje każdy wynik jako „heartbeat" w bazie danych.

3

Wykrycie problemu i retries

Gdy usługa nie odpowiada lub zwraca nieoczekiwany wynik, Uptime Kuma nie panikuje od razu — ponawia próby zgodnie z konfiguracją (np. 3 retries co 60 sekund). Dopiero gdy problem utrzymuje się po wszystkich próbach, usługa jest oznaczana jako DOWN. Ta strategia eliminuje fałszywe alarmy spowodowane chwilowymi problemami sieciowymi.

4

Wysyłka powiadomień

Natychmiast po potwierdzeniu awarii Uptime Kuma wysyła powiadomienia przez wszystkie skonfigurowane kanały — Telegram, Discord, e-mail, SMS, PagerDuty lub dowolny z 91 obsługiwanych serwisów. Opcjonalnie może ponownie wysyłać alerty w ustalonych interwałach (resend notification), dopóki problem nie zostanie rozwiązany.

Cały ten proces odbywa się w czasie rzeczywistym — panel Uptime Kuma aktualizuje się automatycznie dzięki WebSocket (Socket.IO), bez potrzeby odświeżania strony. Wykresy czasu odpowiedzi, historia heartbeatów, statusy monitorów i procent uptime — wszystko aktualizuje się na żywo w przeglądarce.

Retencja danych i wydajność

Uptime Kuma przechowuje dane monitoringu w trzech warstwach:

  • Minutowe dane — ostatnie 24 godziny (szczegółowe heartbeaty)
  • Godzinowe agregaty — ostatnie 30 dni
  • Dzienne agregaty — ostatnie 365 dni

Domyślna retencja to 180 dni — konfigurowalna w ustawieniach. Starsze dane są automatycznie agregowane i usuwane, co zapewnia stałą wydajność nawet przy dużej liczbie monitorów.

SQLite vs MariaDB w wersji 2.x

SQLite jest idealna dla mniejszych wdrożeń (do ~500 monitorów) — nie wymaga konfiguracji, jest lekka i szybka. Dla większych instalacji wersja 2.0 wprowadziła obsługę MariaDB/MySQL, która oferuje lepszą skalowalność, obsługę współbieżnych zapisów i możliwość replikacji. Migracja między bazami jest możliwa za pomocą narzędzi społeczności (np. sqlite3tomysql).

30+ typów monitoringu — kompletna lista

Jedną z największych zalet Uptime Kuma jest wyjątkowo szeroki zakres obsługiwanych typów monitoringu. To nie jest proste narzędzie do pingowania stron — to wszechstronna platforma monitoringu, która obsługuje protokoły od HTTP po SNMP, od MQTT po gRPC, od baz SQL po serwery gier.

Monitoring webowy i API

Typ monitoraOpisZastosowanie
HTTP(s)Sprawdzanie dostępności z walidacją kodu statusu, custom headers, body, auth (Basic, OAuth2, mTLS, NTLM)Strony www, API REST, endpointy health
HTTP(s) KeywordSprawdzanie obecności lub braku tekstu na stronieWykrywanie defacement, monitoring dostępności produktu w sklepie
HTTP(s) JSON QueryWalidacja konkretnych wartości w odpowiedzi JSON za pomocą składni JSONataMonitoring API, walidacja statusów, sprawdzanie wartości w JSON
Real Browser (Chromium)Renderowanie strony w prawdziwej przeglądarce Playwright ze zrzutami ekranuMonitoring SPA, stron wymagających JavaScript do renderowania

Monitoring sieciowy i infrastrukturalny

Typ monitoraOpisZastosowanie
Ping (ICMP)Ping z konfigurowalnym rozmiarem pakietu (1-65500 bajtów) i liczbą próbDostępność serwerów, routerów, urządzeń sieciowych
TCPSprawdzanie dostępności dowolnego portu TCPSSH (22), FTP (21), SMTP (25/587), RDP (3389), dowolne usługi
DNSWalidacja rekordów DNS (A, AAAA, CNAME, MX, TXT, SRV) z konfigurowalnym serwerem DNSWeryfikacja konfiguracji DNS, wykrywanie DNS hijacking, monitoring propagacji
SNMPZapytania SNMP OID (v1, v2c, v3) z walidacją wartościMonitoring urządzeń sieciowych, routerów, switchy, UPS-ów
Tailscale PingPing przez sieć Tailscale (komenda tailscale ping)Monitoring usług w sieci VPN mesh Tailscale
GlobalpingRozproszone sondowanie z wielu lokalizacji na świecie (ping, HTTP, DNS)Monitoring z zewnątrz, wykrywanie problemów regionalnych, weryfikacja CDN

Monitoring baz danych i usług

Typ monitoraOpis
MySQL/MariaDBTest połączenia i opcjonalne wykonanie zapytania SQL z pomiarem czasu
PostgreSQLTest połączenia i zapytania PostgreSQL
MongoDBTest połączenia przez connection string MongoDB
Microsoft SQL ServerTest połączenia MSSQL z autentykacją
Oracle DatabaseTest połączenia z bazą Oracle
RedisTest dostępności serwera Redis (cache/sesje/baza)
Docker ContainerMonitoring stanu kontenera (Running, Healthy, Unhealthy) przez Docker socket lub TCP z TLS
System ServiceSprawdzanie statusu usługi systemd (Linux) lub Windows Service Manager

Monitoring wiadomości, IoT i protokołów specjalistycznych

Typ monitoraOpis
MQTTSubskrypcja topiku MQTT z walidacją wiadomości (keyword, JSON, conditions) — porty 1883/8883
Kafka ProducerTest łączności z brokerem Apache Kafka (SASL + SSL)
RabbitMQSprawdzanie zdrowia nodów RabbitMQ, alertów klastra i multi-node failover
gRPCHealth check i keyword check usług gRPC z obsługą custom Protobuf i TLS
WebSocketWalidacja handshake WebSocket upgrade z opcjonalnym subprotocol
RADIUSTest serwera uwierzytelniania RADIUS (Called/Calling Station IDs)
SIP OptionsPing protokołu SIP przez narzędzie sipsak (VoIP)
SMTPTest połączenia z serwerem pocztowym SMTP

Monitoring specjalistyczny

  • Push (Heartbeat) — pasywny monitoring: zewnętrzne skrypty wysyłają sygnały do Uptime Kuma przez URL endpoint. Idealne do monitorowania zadań cron, backupów, pipeline'ów ETL, Windows Task Scheduler
  • Steam Game Server — monitoring serwerów gier Valve (CS2, TF2, Left 4 Dead) przez Steam Query Protocol
  • GameDig — monitoring ponad 320 typów serwerów gier (Minecraft, ARK: Survival Evolved, Valheim, Rust, DayZ i setki innych) z informacjami o liczbie graczy i wersji
  • Group — logiczne grupowanie monitorów z dziedziczeniem statusu od monitorów-dzieci
Hosting Uptime Kuma na SmartX

Nie chcesz konfigurować serwera, Dockera i reverse proxy? Na SmartXHosting.pl otrzymasz gotową instancję Uptime Kuma pod własną domeną (np. twoja-firma.uptimekuma.eu) — z automatycznymi aktualizacjami, codziennym backupem i wsparciem technicznym. Zacznij monitorować w minuty, nie w godziny.

91 kanałów powiadomień — od Telegram po PagerDuty

Uptime Kuma obsługuje 91 natywnych kanałów powiadomień — to więcej niż jakakolwiek inna darmowa platforma monitoringu na rynku. Dla porównania: Uptime Robot oferuje około 10 kanałów, StatusCake — 14, a nawet płatny New Relic — zaledwie 6. Dodatkowo, dzięki wbudowanej integracji z Apprise (meta-serwis powiadomień), możesz podłączyć kolejne 78+ usług.

Pełna kategoryzacja kanałów powiadomień

  • Komunikatory i chat (20+): Telegram, Discord, Slack, Microsoft Teams, Google Chat, Mattermost, Rocket.Chat, Matrix, Signal, Line, Feishu/Lark, DingTalk, WeCom, Nextcloud Talk, Pumble, Stackfield, Kook, Zoho Cliq, Bitrix24, OneChat
  • Push notifications (10+): Gotify, ntfy, Pushover, Pushbullet, Bark, LunaSea, PushDeer, PushPlus, Pushy, Web Push (przeglądarka), Gorush, ServerChan
  • E-mail (4): SMTP (dowolny serwer pocztowy), SendGrid, Brevo (dawniej Sendinblue), Resend
  • SMS (12+): Twilio (SMS + Voice), SerwerSMS, PromoSMS, ClickSend, 46elks, Cellsynt, SevenIO, SMSC, SMSEagle, SMSIR, SMSManager, SMSPartner, SMS Planet, GTX Messaging, Octopush, Aliyun SMS, Teltonika SMS Gateway
  • WhatsApp (4): WAHA (self-hosted WhatsApp API), Whapi, 360messenger, OneSender
  • Incident Management / On-Call (13): PagerDuty, OpsGenie, Grafana OnCall, Squadcast, FlashDuty, PagerTree, HaloPSA, Heii OnCall, GoAlert, AlertNow, SIGNL4, Keep, Jira Service Management
  • Webhook i automatyzacja (5): Generic Webhook (JSON/form), Apprise (78+ serwisów), Home Assistant, Google Sheets, Nostr

Każdy kanał powiadomień można skonfigurować indywidualnie per monitor — możesz na przykład wysyłać alerty o krytycznych usługach produkcyjnych na PagerDuty z eskalacją on-call, o serwerach deweloperskich na kanał Discord, a o homelabowych usługach na Telegram. Uptime Kuma obsługuje również resend interval — ponowne wysyłanie powiadomień DOWN w ustalonych odstępach czasu, dopóki problem nie zostanie rozwiązany. To kluczowe w sytuacjach, gdy pierwszy alert może zostać przeoczony.

Strony statusu — informuj klientów o stanie usług

Uptime Kuma umożliwia tworzenie publicznych stron statusu — profesjonalnie wyglądających stron informujących użytkowników i klientów o aktualnym stanie monitorowanych usług. To funkcja, za którą dedykowane narzędzia (Statuspage by Atlassian — od 79$/mies., Better Stack — od 21$/mies.) pobierają znaczące miesięczne opłaty. W Uptime Kuma jest to wbudowane i darmowe.

Funkcje stron statusu

  • Wiele stron statusu w jednej instancji — oddzielne strony dla różnych klientów, projektów lub środowisk
  • Custom domain — mapowanie własnej domeny (CNAME) na stronę statusu (np. status.twoja-firma.pl)
  • Personalizacja: tytuł, opis (Markdown), favicon, custom CSS, logo firmy
  • Grupy monitorów z własną kolejnością i wagami na stronie statusu
  • Incidenty: tworzenie, edycja, przypinanie i rozwiązywanie zgłoszeń z pełną historią (style: info, warning, danger, primary)
  • RSS Feed — automatyczny kanał RSS z każdej strony statusu, z konfigurowalnymi tytułem
  • Motyw jasny/ciemny z opcją automatycznego dopasowania do preferencji przeglądarki
  • Ukrywanie „Powered by Uptime Kuma" dla pełnego white-label brandingu
  • Informacje o certyfikacie SSL na stronie statusu (opcjonalnie wyświetlane)
  • PWA manifest — każda strona statusu ma własny manifest.json, umożliwiający instalację jako aplikacja
  • Integracja z analytics — możliwość podłączenia Plausible, Umami lub innego narzędzia analytics

Strona statusu automatycznie wyświetla jeden z pięciu stanów: All Systems Operational (zielony), Partially Degraded Service (żółty), Degraded Service (pomarańczowy), Under Maintenance (niebieski) lub No Services — w zależności od statusów przypisanych monitorów. Aktywne okna maintenance są również wyświetlane na stronie statusu.

Kluczowe funkcje, o których musisz wiedzieć

Monitoring certyfikatów SSL i domen

Uptime Kuma automatycznie wykrywa certyfikaty SSL dla monitorów HTTPS i może wysyłać alerty przed wygaśnięciem certyfikatu (konfigurowalnie: 7, 14 lub 21 dni wcześniej). To szczególnie ważne, gdy korzystasz z Let's Encrypt i chcesz mieć pewność, że automatyczne odnawianie certyfikatu działa poprawnie. Od wersji 2.1 dodano również domain expiry monitoring — sprawdzanie daty wygaśnięcia rejestracji domeny przez protokół RDAP (Whois następnej generacji) z automatycznym odkrywaniem serwera RDAP per TLD.

Okna serwisowe (Maintenance)

Funkcja maintenance windows pozwala zaplanować przerwy serwisowe bez generowania fałszywych alertów. Podczas okna serwisowego monitor przechodzi w stan MAINTENANCE (nie DOWN), powiadomienia są wstrzymane, a strona statusu wyświetla odpowiedni komunikat. Obsługiwane strategie:

  • Ręczne — aktywuj/dezaktywuj manualnie w dowolnym momencie
  • Jednorazowe — z precyzyjną datą początku i końca
  • Cykliczne — dzień tygodnia — np. każda niedziela 02:00–04:00
  • Cykliczne — dzień miesiąca — np. pierwszy dzień miesiąca (lub ostatni)
  • Cykliczne — interwał — co N dni
  • Cron — dowolne wyrażenie cron z czasem trwania w minutach — najwyższa elastyczność

Tagi, grupy i organizacja

Monitory można organizować za pomocą tagów (kolorowe etykiety z parami nazwa:wartość, np. „środowisko:produkcja", „klient:firma-abc") oraz grup (hierarchiczna struktura rodzic-dziecko z wyświetlaniem ścieżki). Grupy dziedziczą status z monitorów-dzieci — jeśli którykolwiek monitor-dziecko jest DOWN, grupa również wykazuje problem. Tagi są eksportowane jako labele w metrykach Prometheus, co umożliwia filtrowanie w Grafanie.

API i integracje programistyczne

Uptime Kuma oferuje dwa typy API do programistycznej integracji:

  • REST API: push monitors (endpoint /api/push/:pushToken), badges shields.io (status, uptime, ping, cert-exp), metryki Prometheus (/metrics), dane stron statusu
  • Socket.IO API (WebSocket): pełny CRUD w czasie rzeczywistym — tworzenie, edycja, usuwanie monitorów, zarządzanie powiadomieniami, status pages, maintenance, tagami, proxy, Docker hosts, remote browsers

Dostępne są biblioteki klienckie: uptime-kuma-api (Python, PyPI), wrapper Go, kolekcja Ansible (lucasheld.uptime_kuma), Terraform provider (breml/uptimekuma) i Postman collection. Wbudowany eksporter Prometheus (endpoint /metrics) umożliwia integrację z Grafaną — dostępne są gotowe dashboardy społeczności (Grafana IDs: 18667, 18278, 16790, 23610).

Badges (odznaki)

Uptime Kuma generuje odznaki w formacie shields.io z pełną personalizacją (label, kolor, styl: flat/plastic/for-the-badge), które możesz umieszczać na stronach, w README na GitHubie lub w dokumentacji:

  • Status badge — Up/Down/Pending/Maintenance
  • Uptime badge — procent dostępności za wybrany okres (24h, 720h, itd.)
  • Ping badge — średni czas odpowiedzi w milisekundach
  • Cert expiry badge — dni do wygaśnięcia certyfikatu SSL

Uwierzytelnianie i bezpieczeństwo

Uptime Kuma obsługuje dwuskładnikowe uwierzytelnianie (2FA) przez TOTP (kompatybilne z Google Authenticator, Authy, Aegis), rate limiting logowania (ochrona przed brute force), walidację siły hasła (biblioteka check-password-strength), sesje JWT oraz API Keys z datą ważności i limitem 60 żądań/minutę. Od wersji 2.0 dostępny jest rootless Docker image (louislam/uptime-kuma:2-rootless) dla zwiększonego bezpieczeństwa kontenerowego.

Ekosystem i społeczność wokół Uptime Kuma

Wokół Uptime Kuma wyrosł bogaty ekosystem narzędzi, integracji i zasobów społeczności. To jeden z najsilniejszych argumentów za wyborem tego narzędzia — masz nie tylko sam monitoring, ale cały ekosystem wsparcia:

Narzędzia automatyzacji

  • AutoKuma — automatyczne tworzenie monitorów na podstawie Docker labels (Infrastructure as Code)
  • Kuma CLI — narzędzie linii komend do zarządzania Uptime Kuma
  • Ansible Collection (lucasheld.uptime_kuma) — pełne moduły do automatyzacji: tworzenie monitorów, powiadomień, status pages, tagów
  • Terraform Provider (breml/uptimekuma) — zarządzanie monitorami jako kodem Terraform
  • uptime-kuma-api (Python) — biblioteka do programistycznej kontroli Uptime Kuma

Aplikacje mobilne i desktopowe

  • PWA (wbudowane) — instalacja interfejsu jako aplikacji na telefonie bezpośrednio z przeglądarki
  • Uptime Kuma Manager — natywna aplikacja iOS + Android (beta)
  • Wuma — aplikacja iOS z widgetami i obsługą Apple Watch
  • kumatray — ikona statusu w system tray Windows
  • xBarApp / Uptime Kuma Notifier — aplikacje menu bar na macOS

Dashboardy i wizualizacje

  • 4 gotowe dashboardy Grafana (IDs: 18667, 18278, 16790, 23610) — wizualizacja metryk Prometheus
  • Homepage (gethomepage.dev) — widget na dashboardzie homelabowym
  • MagicMirror — moduł wyświetlający status na inteligentnym lustrze
  • Kuma Mieru — alternatywny dashboard Next.js z Recharts

Platformy wdrożeniowe

Uptime Kuma można wdrożyć na praktycznie każdej platformie: Docker/Docker Compose (najpopularniejsza metoda), Kubernetes (4+ Helm chartów), Proxmox (LXC/VM), Synology NAS, QNAP, TrueNAS SCALE (natywna aplikacja od v24.10), Unraid, Raspberry Pi, Coolify, Railway, Fly.io, Koyeb, Cloudron, YunoHost, CasaOS i wiele innych.

Społeczność

Uptime Kuma ma jedną z najaktywniejszych społeczności w ekosystemie self-hosted. Tłumaczenia na 50+ języków (w tym polski!) są zarządzane przez platformę Weblate. Dyskusje toczą się na GitHubie (Issues, Discussions), Reddicie (r/selfhosted, r/homelab), forach Cloudron, ArturHome (PL) i wielu blogach technicznych. Projekt przyjmuje pull requests od społeczności — większość z 91 notification providers została napisana przez wolontariuszy.

Self-hosting vs hosting zarządzany — co wybrać

Uptime Kuma jako narzędzie self-hosted daje Ci pełną kontrolę nad danymi i konfiguracją. Ale to również oznacza, że musisz zadbać o serwer, aktualizacje, backup, bezpieczeństwo i troubleshooting samodzielnie. Paradoks „monitorowania monitoringu" — kto pilnuje, czy Twoja Uptime Kuma nadal działa? Porównajmy oba podejścia:

AspektSelf-hosting (DIY)Hosting zarządzany (SmartX)
Czas uruchomienia30–60 minut (Docker + reverse proxy + SSL)Kilka minut (gotowa instancja)
Konfiguracja serweraWymagana (Linux, Docker, Nginx/Caddy)Nie wymagana — wszystko gotowe
AktualizacjeRęczne (docker pull + restart)Automatyczne do najnowszej wersji
BackupMusisz skonfigurować samodzielnieCodzienny, automatyczny
SSL/HTTPSKonfiguracja Let's Encrypt + reverse proxyGotowe, automatyczne odnowienie
DomenaWłasna domena + konfiguracja DNSSubdomena .uptimekuma.eu w cenie
Wsparcie techniczneSpołeczność (GitHub, Reddit)Dedykowane wsparcie SmartX
Koszt serweraVPS od ~15–30 PLN/mies.W cenie usługi hostingu
Koszt czasu adminaMaintenance, troubleshooting, aktualizacjeZero — wszystko zarządzane
Kontrola nad danymiPełna (Twój serwer)Dane w polskim data center SMARTX

Self-hosting jest świetny dla homelabowców, deweloperów i firm z dedykowanym zespołem IT, które chcą pełnej kontroli. Hosting zarządzany na SmartXHosting.pl jest idealny dla firm, agencji i freelancerów, którzy chcą po prostu monitorować — bez tracenia czasu na administrację serwerem.

Gotowy hosting Uptime Kuma — bez konfiguracji

Zamów hosting Uptime Kuma na SmartXHosting.pl i zacznij monitorować swoje usługi w kilka minut. Gotowa instancja pod własną subdomeną, automatyczne aktualizacje, codzienny backup i wsparcie techniczne w języku polskim.

Zamów hosting Uptime Kuma

Dla kogo jest Uptime Kuma — scenariusze zastosowań

Uptime Kuma sprawdzi się w zaskakująco wielu scenariuszach — od homelaba hobbystycznego po krytyczną infrastrukturę produkcyjną. Oto najczęstsze zastosowania z praktycznymi wskazówkami:

Właściciele stron i sklepów internetowych

Monitoruj dostępność swojego sklepu (WooCommerce, PrestaShop, Magento), sprawdzaj czy checkout działa poprawnie (HTTP monitor na /checkout z oczekiwanym status code 200), kontroluj czas odpowiedzi strony głównej i certyfikat SSL. Keyword monitor powie Ci natychmiast, gdy na stronie pojawi się komunikat „Error establishing a database connection" zamiast treści. JSON Query monitor może weryfikować odpowiedź Twojego API płatności.

Agencje webowe i freelancerzy

Monitoruj dziesiątki stron klientów z jednego panelu. Tagi per klient (np. „klient:firma-abc"), grupy monitorów per środowisko, osobne strony statusu z custom domeną (status.firma-klienta.pl), powiadomienia na dedykowane kanały Slack. Odznaka uptime na fakturze jako dowód realizacji SLA. Na jednej instancji Uptime Kuma możesz monitorować 50–100 stron bez problemów z wydajnością.

Administratorzy IT i DevOps

Monitoruj serwery (Ping), porty usług (TCP — SSH 22, RDP 3389, FTP 21), bazy danych (MySQL, PostgreSQL, Redis z zapytaniami testowymi), kontenery Docker (stan kontenerów przez socket), API microservices (HTTP JSON Query, gRPC), kolejki wiadomości (Kafka, RabbitMQ), urządzenia sieciowe (SNMP v3). Integracja z Prometheus + Grafana dla pełnego dashboardu metryk i alertów. Ansible/Terraform do zarządzania monitorami jako kodem.

Homelabowcy i entuzjaści self-hosted

Monitoruj Nextcloud, Plex, Jellyfin, Home Assistant, Pi-hole, Vaultwarden, Gitea, Immich, Paperless-ngx i dziesiątki innych self-hosted usług. Docker container monitoring przez socket daje pełen obraz stanu Twojego stosu. Push monitor dla cronjobów i backupów (Borgmatic, Restic). Powiadomienia na Telegram lub Gotify (self-hosted). Status page dla rodziny — „czy Plex działa?".

Społeczności gamingowe

GameDig obsługuje ponad 320 typów serwerów gier — Minecraft, CS2, Valheim, ARK, Rust, DayZ, Terraria i setki innych. Publiczna strona statusu pokaże graczom w czasie rzeczywistym, czy serwer jest online i ilu graczy jest podłączonych. Discord bot z live statusem na kanale serwera — społeczność wie bez pytania.

ISP, hosting i MSP (Managed Service Providers)

Centralne monitorowanie infrastruktury klientów, SLA tracking z procentem uptime (badges), branded white-label status pages, integracja z systemami ticketowymi (Jira SM, PagerDuty, OpsGenie). Monitoring jako usługa (Monitoring as a Service) — oferuj klientom gotową instancję Uptime Kuma jako element pakietu zarządzanego hostingu.

Jak zacząć korzystać z Uptime Kuma

Najszybszym sposobem na uruchomienie Uptime Kuma jest hosting zarządzany. Na SmartXHosting.pl otrzymasz gotową instancję Uptime Kuma pod własną domeną (np. twoja-firma.uptimekuma.eu) — z automatycznymi aktualizacjami, codziennym backupem i wsparciem technicznym. Zacznij monitorować w minuty, nie w godziny.

Po uruchomieniu instancji otwórz przeglądarkę, utwórz konto administratora i dodaj pierwszy monitor. To dosłownie kilka minut od zamówienia do działającego monitoringu.

Podsumowanie

Uptime Kuma to potężne, darmowe i open-source'owe narzędzie do monitorowania dostępności usług internetowych, które zdobyło zaufanie ponad 84 000 użytkowników na GitHubie i jest pobierane ponad 100 milionów razy z Docker Hub. Łączy prostotę wdrożenia z rozbudowaną funkcjonalnością, której nie oferują nawet płatne rozwiązania konkurencji.

Kluczowe argumenty za Uptime Kuma:

  • 30+ typów monitorów — od HTTP po MQTT, od Docker Container po GameDig (320+ gier)
  • 91 kanałów powiadomień — Telegram, Discord, Slack, SMS, PagerDuty, Jira SM i wiele więcej
  • Konfigurowalne strony statusu — profesjonalne, z custom domeną, CSS i white-label
  • Integrację z ekosystemem DevOps — Prometheus, Grafana, Home Assistant, Terraform, Ansible
  • Prostotę wdrożenia — 5 minut od zera do działającego monitoringu
  • Zerowe koszty licencji — licencja MIT, bez ograniczeń, bez limitów monitorów
  • Aktywną społeczność — 50+ języków, regularne aktualizacje, bogaty ekosystem narzędzi

Niezależnie od tego, czy monitorujesz jedną stronę firmową, dziesiątki stron klientów jako agencja, infrastrukturę homelab czy krytyczne środowisko produkcyjne z bazami danych i microservices — Uptime Kuma jest narzędziem, które warto poznać i wdrożyć. A jeśli chcesz skupić się na monitorowaniu zamiast na administracji serwerem — hosting zarządzany na SmartXHosting.pl jest gotowy na Ciebie.

Zacznij monitorować swoje usługi już dziś

Zamów hosting Uptime Kuma na SmartXHosting.pl — gotowa instancja, własna subdomena .uptimekuma.eu, automatyczne aktualizacje i codzienny backup. Zero konfiguracji serwera, pełne wsparcie techniczne.

Zamów hosting Uptime Kuma

Najczęściej zadawane pytania

Czy Uptime Kuma jest naprawdę darmowa?
Tak. Uptime Kuma jest wydana na licencji MIT — możesz ją używać bez ograniczeń, zarówno prywatnie, jak i komercyjnie. Nie ma limitów na liczbę monitorów, kanałów powiadomień ani stron statusu. Jedynym kosztem jest serwer, na którym ją uruchomisz (lub opcjonalnie hosting zarządzany, który eliminuje potrzebę własnego serwera).
Ile monitorów obsługuje Uptime Kuma?
Nie ma sztucznego limitu liczbowego. Na SQLite wydajność jest optymalna do około 500 monitorów przy 20-sekundowym interwale. Od wersji 2.0 możesz użyć MariaDB/MySQL jako bazy danych, co znacząco zwiększa skalowalność i obsługę współbieżnych zapisów. Wymagania sprzętowe: minimum 1 GB RAM, zalecane 2 GB dla 200+ monitorów.
Czy Uptime Kuma obsługuje monitoring z wielu lokalizacji?
Od wersji 2.1 (luty 2026) Uptime Kuma obsługuje Globalping — rozproszone sondowanie z wielu lokalizacji na świecie (ping, HTTP, DNS) dzięki sieci sond jsdelivr. Wcześniej monitoring odbywał się wyłącznie z jednej lokalizacji. Alternatywnie możesz uruchomić wiele instancji Uptime Kuma w różnych regionach i zsynchronizować je za pomocą narzędzia replicator-kuma.
Jakie są wymagania systemowe Uptime Kuma?
Dla instalacji Docker: dowolny system z Dockerem (Linux, Windows, macOS). Dla bare metal: Node.js 20.4+. RAM: minimum 1 GB, zalecane 2 GB. Dysk: kilkaset MB na aplikację + dane (rosną z liczbą monitorów i retencją danych). Obsługiwane systemy: Linux (Debian, Ubuntu, Fedora, Arch, AlmaLinux), Windows 10+/Server 2012 R2+. FreeBSD i OpenBSD nie są oficjalnie wspierane. Raspberry Pi 3/4/5 jest w pełni obsługiwany (obraz ARM).
Czy mogę monitorować kontenery Docker bezpośrednio?
Tak. Uptime Kuma ma wbudowany typ monitora Docker Container, który sprawdza stan kontenera (Running, Healthy, Unhealthy, Paused, Restarting) przez Docker socket (/var/run/docker.sock) lub Docker TCP z certyfikatami TLS. Możesz monitorować wiele Docker hostów jednocześnie. Dla bezpieczeństwa zalecamy Docker socket proxy (np. Tecnativa/docker-socket-proxy) zamiast bezpośredniego montowania socketa.
Czym różni się Uptime Kuma od Uptime Robot?
Uptime Robot to usługa SaaS z ograniczonym darmowym planem (50 monitorów, 5-minutowy interwał, tylko użytek niekomercyjny od października 2024). Uptime Kuma jest self-hosted (lub hosting zarządzany), darmowa bez ograniczeń, z 20-sekundowym minimalnym interwałem, 30+ typami monitorów (vs 4 w Uptime Robot), 91 kanałami powiadomień (vs ~10) i wbudowanymi stronami statusu. Uptime Robot oferuje natomiast monitoring z wielu lokalizacji out-of-the-box i zero wymagań serwerowych. Szczegółowe porównanie znajdziesz w naszym artykule „Uptime Kuma vs Uptime Robot".
Czy Uptime Kuma ma aplikację mobilną?
Uptime Kuma ma wbudowaną obsługę PWA (Progressive Web App) — możesz „zainstalować" interfejs na telefonie bezpośrednio z przeglądarki (Chrome → Menu → Dodaj do ekranu głównego). Dodatkowo dostępne są aplikacje społeczności: Uptime Kuma Manager (iOS + Android w wersji beta), Wuma (iOS z widgetami i obsługą Apple Watch) i Uptime Mate (Apple Watch). Na Androidzie najlepszym rozwiązaniem jest PWA — działa płynnie i aktualizuje się automatycznie.