Hostovat Uptime Kuma na Managed VPS: sledujte své služby nepřetržitě

Co Uptime Kuma sleduje

Uptime Kuma se v pravidelných intervalech, až každých 20 sekund, dotazuje vašich služeb, uchovává historii jejich odpovědí a upozorní vás, jakmile některá přestane odpovídat. Ovládá se z webového rozhraní, které je dostupné v několika jazycích.

• Sondy: HTTP a HTTPS, hledání klíčového slova na stránce, požadavek JSON, TCP, WebSocket, ping, záznam DNS, kontejnery Docker a sonda „push“ pro naplánovanou úlohu, která sama hlásí, že proběhla.
• Upozornění: více než 90 služeb pro oznámení, mezi nimi Telegram, Discord, Slack a e-mail.
• Stavové stránky: několik veřejných stránek, každou můžete provozovat na vlastní doméně.
• Certifikáty: údaje o certifikátu HTTPS každé sledované služby.
• Účet: dvoufázové ověření a průchod přes proxy pro sondy, které ji potřebují.

Umístěte Uptime Kuma na jiný server než služby, které sleduje. Na samostatném stroji vidí výpadek zvenčí a odešle upozornění, zatímco vaše služby stojí.

Co dovoluje licence MIT

Uptime Kuma je vydáván pod licencí MIT. Dovoluje software používat, kopírovat, upravovat, slučovat, publikovat, šířit, sublicencovat a prodávat, za jediné podmínky: ve všech kopiích zachovat upozornění na autorská práva a text licence.

Uptime Kuma tedy můžete ve firmě provozovat, sledovat v něm služby svých zákazníků a otevřít jim stavové stránky, aniž byste kupovali licenci.

Instalace pomocí Docker Compose

Dokumentace Uptime Kuma začíná u Docker Compose. Na serveru s nainstalovaným Dockerem vytvořte složku a stáhněte oficiální soubor:

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

Soubor projektu publikuje port 3001 na všech adresách serveru. Za reverzní proxy ho omezte na lokální adresu, jak to 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 ve výchozím nastavení publikuje na všech adresách serveru, a to ještě před pravidly firewallu ufw. Lokálně je Uptime Kuma dostupný jen přes reverzní proxy.
• Složka data na lokálním disku: uchovává databázi kuma.db, nahrané soubory a snímky obrazovky. Projekt NFS a další síťové souborové systémy nedoporučuje, protože SQLite potřebuje spolehlivé zamykání souborů.
• Značka 2 sleduje verzi 2 Uptime Kuma a přechod na další hlavní verzi zůstává vaším rozhodnutím.
• Obraz 2-slim je lehčí, stahuje se zhruba 185 MB oproti 620 MB: vynechává Chromium a integrovanou MariaDB, které obsahuje obraz 2. Obraz 2 projekt doporučuje a sonda „Browser Engine“ pak s 2-slim vyžaduje externí Chromium.

Při prvním spuštění otevřete rozhraní: průvodce vás nechá zvolit databázi a poté vytvořit účet správce. Dvoufázové ověření zapněte hned při prvním přihlášení.

Projekt neuvádí nároky na paměť ani procesor: velikost závisí na počtu sledovaných služeb a na požadované frekvenci. Na Managed VPS nám popište své využití a doporučíme vám vhodnou velikost.

HTTPS a WebSocket: reverzní proxy

Ve veřejné síti projekt vyžaduje HTTPS. Uptime Kuma stojí na WebSocketu: reverzní proxy musí předávat hlavičky Upgrade a Connection. Obsluhuje se v kořeni domény nebo subdomény a jeho wiki podsložky jako example.com/uptimekuma nedoporučuje.

S Caddy

Caddy si certifikát získává a obnovuje sám a WebSocket předává bez dalšího nastavení:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

S Nginx a 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 pak nainstaluje certifikát Let's Encrypt a přesměrování na HTTPS a certifikát poté obnovuje sám:

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

Když je Uptime Kuma dostupný jen přes proxy, otevřete jeho nastavení, „Settings“, „Reverse Proxy“, „HTTP Headers“, a přepněte „Trust Proxy“ na „Yes“: v protokolech se pak zobrazí skutečná adresa návštěvníků.

SQLite, nebo MariaDB

Od verze 2 nabízí Uptime Kuma tři databáze, které si vyberete v průvodci prvního spuštění:

Chcete-li volbu určit předem, bez průvodce, přidejte proměnné 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 ke službě v souboru compose.yaml.

Oznámení, včetně e-mailu

Sonda má smysl, jen když se upozornění dostane k vám. Své kanály nadeklarujte v „Settings“, „Notifications“, z každého odešlete zkušební zprávu a počítejte s dvěma, například s messengerem a e-mailem: když jeden vypadne, převezme to druhý.

Pro e-mail se Uptime Kuma připojuje k serveru SMTP. Na VPS Simafri vede odesílání přes ověřené relé na portu 587: adresa poštovního účtu, který už máte, nebo Simafri Suite.

Zálohy a aktualizace

Od verze 2 je záloha složky data jedinou metodou, kterou projekt podporuje. S SQLite nebo s integrovanou MariaDB v ní je všechno. Databáze SQLite zkopírovaná uprostřed zápisu může být poškozená: po dobu kopírování kontejner zastavte, s vědomím, že se s ním zastaví i sondy.

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

Aktualizace

Wiki projektu uvádí dva příkazy, ze složky se souborem compose.yaml. Složka data zůstává na místě:

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

Před každou aktualizací si přečtěte poznámky k vydání: některé obsahují bezpečnostní opravy, například verze 2.5.9 z 31. října 2026. Záloha těsně předtím vám dá snadný návrat.

Přechod z verze 1 na verzi 2 vyžaduje větší péči: zálohujte složku data při zastaveném kontejneru a nechte migraci dojít do konce, protože po přerušené migraci je nutné zálohu obnovit. Projekt naměřil zhruba 7 minut pro 20 sond a 90 dní historie, na skromném stroji nebo s více sondami mnohem déle.

Kdo co dělá na Managed VPS

Vlastní hosting vyžaduje, abyste kromě aplikace udržovali i server. Na Managed VPS se serveru ujímají naše týmy a vaši instanci proaktivně sledují; Uptime Kuma zůstává vaším softwarem, s jeho nastavením a daty.

Pokud dáváte přednost tomu, aby naše týmy zasáhly přímo v aplikaci, tato služba se účtuje po hodinách nebo paušálem, s cenovou nabídkou sdělenou před zásahem.