Hostovanie Uptime Kuma na Managed VPS: sledujte svoje služby nepretržite

Čo Uptime Kuma sleduje

Uptime Kuma sa vašich služieb pravidelne pýta, až každých 20 sekúnd, uchováva históriu ich odpovedí a upozorní vás, len čo niektorá prestane odpovedať. Používa sa z webového rozhrania, dostupného vo viacerých jazykoch.

• Sondy: HTTP a HTTPS, hľadanie kľúčového slova na stránke, požiadavka JSON, TCP, WebSocket, ping, záznam DNS, kontajnery Docker a sonda „push“ pre plánovanú úlohu, ktorá sama hlási, že prebehla.
• Upozornenia: viac než 90 notifikačných služieb, medzi nimi Telegram, Discord, Slack a e-mail.
• Stavové stránky: viacero verejných stránok, každá na vlastnej doméne, ak si to želáte.
• Certifikáty: údaje o certifikáte HTTPS každej sledovanej služby.
• Účet: dvojfaktorové overenie a prechod cez proxy pre sondy, ktoré ho potrebujú.

Uptime Kuma umiestnite na iný server než služby, ktoré sleduje. Na samostatnom stroji vidí výpadok zvonka a pošle upozornenie, kým sú vaše služby vypnuté.

Čo umožňuje licencia MIT

Uptime Kuma vychádza pod licenciou MIT. Dovoľuje softvér používať, kopírovať, upravovať, zlučovať, zverejňovať, šíriť, udeľovať podlicencie a predávať, s jednou podmienkou: v každej kópii zachovať upozornenie o autorských právach a text licencie.

Uptime Kuma teda môžete prevádzkovať vo firme, sledovať v ňom služby svojich zákazníkov a otvoriť im stavové stránky, bez licencie, ktorú by ste museli kupovať.

Inštalácia pomocou Docker Compose

Dokumentácia Uptime Kuma začína Docker Compose. Na serveri s nainštalovaným Dockerom vytvorte priečinok a stiahnite oficiálny súbor:

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

Súbor projektu publikuje port 3001 na všetkých adresách servera. Za reverznou proxy ho obmedzte na lokálnu adresu, ako navrhuje 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 publikovaný na 127.0.0.1: Docker predvolene publikuje na všetkých adresách servera, ešte pred pravidlami firewallu ufw. Lokálne je Uptime Kuma dostupný jedine cez reverznú proxy.
• Priečinok data na lokálnom disku: uchováva databázu kuma.db, odoslané súbory a snímky obrazovky. Projekt vylučuje NFS a ďalšie sieťové súborové systémy, pretože SQLite potrebuje spoľahlivé zámky súborov.
• Značka 2 sleduje verziu 2 Uptime Kuma a prechod na ďalšiu hlavnú verziu zostáva vaším rozhodnutím.
• Obraz 2-slim je ľahší, približne 185 MB na stiahnutie oproti 620 MB: vynecháva Chromium a vstavanú MariaDB, ktoré obsahuje obraz 2. Obraz 2 je ten, ktorý projekt odporúča, a sonda „Browser Engine“ si s 2-slim vyžiada externé Chromium.

Pri prvom spustení otvorte rozhranie: sprievodca vás nechá vybrať databázu a potom vytvoriť účet správcu. Dvojfaktorové overenie zapnite hneď pri prvom prihlásení.

Projekt neuvádza nároky na pamäť ani procesor: veľkosť závisí od počtu sledovaných služieb a od požadovanej frekvencie kontrol. Na spravovanom VPS (Managed VPS) nám opíšte svoje použitie a odporučíme vám vhodnú veľkosť.

HTTPS a WebSocket: reverzná proxy

Vo verejnej sieti projekt vyžaduje HTTPS. Uptime Kuma sa opiera o WebSocket: reverzná proxy musí prepúšťať hlavičky Upgrade a Connection. Obsluhuje sa v koreni domény alebo subdomény a jeho wiki vylučuje podpriečinky ako example.com/uptimekuma.

S Caddy

Caddy získava a obnovuje certifikát sám a WebSocket prepúšťa bez ďalšieho nastavovania:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

S Nginx a Certbotom

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 potom nainštaluje certifikát Let’s Encrypt a presmerovanie na HTTPS a certifikát si následne obnovuje sám:

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

Keď je Uptime Kuma dostupný len cez proxy, otvorte jeho nastavenia, „Settings“, „Reverse Proxy“, „HTTP Headers“, a prepnite „Trust Proxy“ na „Yes“: v záznamoch sa potom zobrazuje skutočná adresa návštevníkov.

SQLite alebo MariaDB

Od verzie 2 ponúka Uptime Kuma tri databázy, ktoré si vyberiete v sprievodcovi pri prvom spustení:

Ak chcete voľbu určiť vopred, bez sprievodcu, pridajte do služby v súbore compose.yaml premenné UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME a UPTIME_KUMA_DB_PASSWORD.

Upozornenia vrátane e-mailu

Sonda má zmysel, len ak upozornenie k vám dorazí. Svoje kanály nastavte v „Settings“, „Notifications“, z každého pošlite skúšobnú správu a zriaďte aspoň dva, napríklad komunikátor a e-mail: ak jeden vypadne, druhý ho zastúpi.

Pre e-mail sa Uptime Kuma pripája na server SMTP. Na VPS Simafri odosielanie prechádza cez overené relé na porte 587: adresa poštového účtu, ktorý už máte, alebo Simafri Suite.

Zálohy a aktualizácie

Od verzie 2 je záloha priečinka data jedinou metódou, ktorú projekt podporuje. So SQLite alebo vstavanou MariaDB sa v ňom nachádza všetko. Databáza SQLite skopírovaná počas zápisu sa môže poškodiť: kontajner na čas kopírovania zastavte, pričom sa spolu s ním zastavia aj sondy.

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

Aktualizácia

Wiki projektu uvádza dva príkazy, spúšťané z priečinka so súborom compose.yaml. Priečinok data zostáva na mieste:

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

Pred každou aktualizáciou si prečítajte poznámky k vydaniu: niektoré obsahujú bezpečnostné opravy, ako verzia 2.5.9 z 31. októbra 2026. Záloha tesne predtým vám zaistí jednoduchý návrat.

Prechod z verzie 1 na verziu 2 vyžaduje väčšiu opatrnosť: zálohujte priečinok data pri zastavenom kontajneri a nechajte migráciu dobehnúť do konca, pretože prerušená migrácia si vyžaduje obnovu zo zálohy. Projekt zaznamenal približne 7 minút pre 20 sond a 90 dní histórie, na skromnejšom stroji alebo s väčším počtom sond však podstatne viac.

Kto čo robí na Managed VPS

Hostovanie na vlastnom serveri vyžaduje popri aplikácii starať sa aj o server. Na Managed VPS preberajú server naše tímy a vašu inštanciu proaktívne sledujú; Uptime Kuma zostáva vaším softvérom, s vašimi nastaveniami a údajmi.

Ak by ste uprednostnili, aby naše tímy zasiahli priamo v aplikácii, táto služba sa fakturuje hodinovo alebo paušálne, s cenovou ponukou oznámenou pred zásahom.