Hostovat Umami na Managed VPS: vaše webová analytika na vašem serveru

Co Umami umí

Umami je otevřená platforma pro analytiku webů a produktů. Jeho dokumentace popisuje nástroj, který spojuje návštěvnost, kampaně, chování návštěvníků, konverze, retenci a tržby, od první návštěvy po výsledky, na kterých vaší firmě záleží. Je napsaný v TypeScriptu nad Next.js a jeho obraz Docker běží pod účtem bez zvláštních práv.

• Akvizice: zobrazení stránek, návštěvníci, odkazující weby, země, zařízení a aktivita v reálném čase, s kampaněmi UTM, krátkými odkazy a měřicími pixely.
• Chování: vlastní události, cesty, záznamy relací, teplotní mapy, segmenty, kohorty a retence.
• Konverze: cíle, trychtýře, atribuce a sledování tržeb podle stránky a podle kampaně.
• Sdílení: nástěnky, týmy, veřejná adresa pro sdílení, API a server MCP jen pro čtení pro vašeho AI asistenta.
• Moderní weby: FAQ uvádí, že Umami v jednostránkových aplikacích sleduje navigaci mezi stránkami samo, bez dalšího nastavení.

Jedna instance sleduje několik webů: každý dostane vlastní ID a měřicí skript a vaši kolegové se v nich vyznají díky účtům a týmům.

Co dovoluje licence MIT

Umami je vydáván pod licencí MIT, jménem Umami Software, Inc. Ta bezplatně uděluje právo software používat, kopírovat, upravovat, slučovat, zveřejňovat, šířit, sublicencovat a prodávat jeho kopie. Můžete ho tedy provozovat pro svou firmu i pro weby svých klientů, aniž byste kupovali licenci.

Její jedinou podmínkou je, že upozornění o autorských právech a upozornění o oprávnění doprovázejí všechny kopie nebo podstatné části softwaru. Jako každá licence MIT poskytuje software „tak, jak je“, bez záruky.

Cookies a osobní údaje: co říká projekt

Dokumentace představuje Umami jako analytiku bez cookies, bez sledování napříč weby a bez automatického sběru osobních údajů. Při vlastním hostingu zůstávají vaše statistiky na vašem vlastním serveru: rozhodujete, kde budou a jak dlouho se uchovají.

Tři nastavení měřicího skriptu jdou podle přání dál: data-exclude-search odstraní z ukládaných adres parametry vyhledávání, data-exclude-hash odstraní kotvu a data-do-not-track vypne měření u prohlížečů, které zveřejňují preferenci Do Not Track. Dokumentace poznamenává, že toto poslední nastavení samo o sobě není úplným řešením správy souhlasu.

Pokud přihlášené návštěvníky identifikujete pomocí data-distinct-id nebo umami.identify(), dokumentace doporučuje interní ID uživatele nebo haš místo e-mailové adresy: hodnotu lze přečíst v HTML stránky.

Instalace pomocí Docker Compose a PostgreSQL

Repozitář dodává docker-compose.yml, který spouští Umami a jeho databázi PostgreSQL. Od verze 3 je PostgreSQL jedinou podporovanou databází, minimálně ve verzi 12.14, a dokumentace doporučuje nastavit ji na časové pásmo UTC. Na serveru s nainstalovaným Dockerem vytvořte složku a začněte jejími tajnými údaji, náhodně vygenerovanými pomocí openssl, jak navrhuje dokumentace:

cat > .env <<EOF
POSTGRES_PASSWORD=$(openssl rand -hex 24)
APP_SECRET=$(openssl rand -hex 32)
TWO_FACTOR_ENCRYPTION_KEY=$(openssl rand -hex 32)
EOF
chmod 600 .env

Pak vedle něj umístěte tento compose.yaml. Vychází ze souboru projektu ve verzi 3.4.1, se dvěma změnami: tajné údaje pocházejí ze souboru .env a port je publikovaný jen na 127.0.0.1.

services:
  umami:
    image: ghcr.io/umami-software/umami:latest
    ports:
      - "127.0.0.1:3000:3000"
    environment:
      DATABASE_URL: postgresql://umami:${POSTGRES_PASSWORD}@db:5432/umami
      APP_SECRET: ${APP_SECRET}
      TWO_FACTOR_ENCRYPTION_KEY: ${TWO_FACTOR_ENCRYPTION_KEY}
    depends_on:
      db:
        condition: service_healthy
    init: true
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "curl http://localhost:3000/api/heartbeat"]
      interval: 5s
      timeout: 5s
      retries: 5
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - umami-db-data:/var/lib/postgresql/data
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5
volumes:
  umami-db-data:

docker compose up -d
curl -s http://127.0.0.1:3000/api/heartbeat

• DATABASE_URL: jediná povinná proměnná, připojovací řetězec k databázi. Šestnáctkové heslo se vkládá tak, jak je; heslo se speciálními znaky by vyžadovalo procentuální kódování.
• APP_SECRET: náhodný řetězec, který zabezpečuje ověřovací tokeny, jedinečný pro každou instalaci. V kódu verze 3.4.1 vstupuje také do výpočtu ID relací: ponechte ho neměnný.
• TWO_FACTOR_ENCRYPTION_KEY: 64 šestnáctkových znaků, které šifrují tajné údaje dvoufázového ověření. Bez něj nikdo dvoufázové ověření nezapne.
• Při spuštění kontejner ověří připojení k databázi a její verzi a pak sám použije migrace schématu. Při prvním spuštění vytvoří tabulky a účet admin. Sonda /api/heartbeat odpoví {"ok":true}, jakmile je Umami připraven.
• Značka latest sleduje poslední zveřejněné vydání. Registr projektu zveřejňuje i značky verzí, jako 3.4.1, kterými pevně určíte tu, kterou provozujete.

Instalační dokumentace neuvádí žádný údaj o paměti ani procesoru. Velikost závisí na návštěvnosti sledovaných webů a na objemu dat, která uchováváte. Na Managed VPS nám popište své využití a doporučíme vám vhodnou velikost.

HTTPS: reverzní proxy

Umami naslouchá přes HTTP na portu 3000 a dokumentace navrhuje provozovat ho za vaším webovým serverem, přes reverzní proxy. Dejte mu vlastní subdoménu, například stats.example.com, která na server ukazuje záznamy A a AAAA. Provoz Umami pod cestou vede přes BASE_PATH, proměnnou čtenou při sestavení aplikace: se zveřejněným obrazem je subdoména přímou cestou.

Proxy musí také předávat adresu návštěvníka. Umami ji čte z hlaviček, které dostává, mimo jiné z X-Real-IP a X-Forwarded-For: slouží mu k rozlišení návštěvníků a k určení jejich země. Pokud vaše proxy používá jinou hlavičku, pojmenuje ji CLIENT_IP_HEADER.

S Caddy

Caddy získá certifikát Let’s Encrypt a zapne HTTPS samo. Jeho direktiva reverse_proxy ve výchozím nastavení nastavuje X-Forwarded-For: tyto tři řádky stačí.

stats.example.com {
  reverse_proxy 127.0.0.1:3000
}

S Nginx a Certbotem

Tento blok vychází z příkladu Nginx v dokumentaci Umami a naslouchá na portu 80, aby HTTPS nasadil Certbot:

server {
  listen 80;
  listen [::]:80;
  server_name stats.example.com;

  location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}

Certbot pak nainstaluje certifikát a postará se o jeho obnovu:

sudo certbot --nginx

První přihlášení: účet admin a dvoufázové ověření

Při vytváření databáze otevře Umami účet správce: uživatelské jméno admin, heslo umami. Dokumentace žádá toto heslo změnit při prvním přihlášení.

1. Otevřete svou adresu HTTPS a přihlaste se pomocí admin a umami.
2. Otevřete Settings tlačítkem profilu v postranním panelu, pak Profile a klikněte na Change password.
3. Na kartě Security zapněte dvoufázové ověření: naskenujte QR kód svou ověřovací aplikací, zadejte šestimístný kód a pak uložte deset záložních kódů na bezpečné místo, protože se zobrazí jen jednou.

• Vyžadování dvoufázového ověření: správce ho může vyžadovat pro celou instanci, pro jednoho uživatele nebo pro jeden tým, ze stránek správy.
• Pokusy: pět chybných kódů zablokuje další pokusy na 15 minut.
• Účty vašeho týmu: stránky správy spravují uživatele, weby a týmy celé instance.

Uchovávejte TWO_FACTOR_ENCRYPTION_KEY se svými zálohami: dokumentace upozorňuje, že ztráta nebo změna tohoto klíče učiní uložené tajné údaje nečitelnými a každý uživatel si pak musí dvoufázové ověření nastavit znovu.

Přidání webu a jeho měřicího skriptu

1. V Websites klikněte na Add website.
2. Zadejte název webu a pak jeho doménu: Umami ji používá k odfiltrování vašich vlastních stránek ze seznamu odkazujících webů.
3. U tohoto webu otevřete Edit a zkopírujte kód z části Tracking code.
4. Vložte ho do <head> svých stránek a pak navštivte svůj web: data se v přehledu objeví okamžitě.

<script defer src="https://stats.example.com/script.js" data-website-id="your-website-id"></script>

• Nic se nezobrazuje? Dokumentace navrhuje kartu Síť ve vývojářských nástrojích prohlížeče: požadavky na vaši instanci by měly odcházet bez chyb.
• Next.js: přidejte kód komponentou next/script místo prosté značky <script>.
• data-domains omezí měření na vaše produkční domény, čímž zůstanou vaše testovací prostředí mimo statistiky.
• Vaše vlastní návštěvy se vylučují web po webu, z konzole prohlížeče, pomocí localStorage.setItem('umami.disabled', 1).

Vlastní název skriptu

Některé blokátory reklam blokují vše, co připomíná analytiku. Při vlastním hostingu se Umami už nabízí z vaší vlastní domény a dvě proměnné jdou dál: TRACKER_SCRIPT_NAME dá skriptu jiný název než script.js a COLLECT_API_ENDPOINT přejmenuje sběrný koncový bod místo /api/send. Skript pak nový koncový bod volá sám; na vašich stránkách se mění jen zdroj měřicího kódu.

TRACKER_SCRIPT_NAME: "stats.js"
COLLECT_API_ENDPOINT: "/api/collect"

Užitečná nastavení

Tyto proměnné prostředí patří do služby umami v compose.yaml a docker compose up -d pak kontejner znovu vytvoří, aby je převzal:

Zálohy

Vše, co Umami uchovává, je v jeho databázi PostgreSQL: účty, weby, týmy a statistiky. Exportujte ji každý den a těsně před každou aktualizací: při vlastním hostingu se tato data uchovávají bez časového omezení. Vedle databáze obsahuje soubor .env tajné údaje, díky kterým je použitelná:

Export databáze za běhu

pg_dump vytvoří konzistentní export, i když se databáze používá. Vlastní formát, -Fc, je komprimovaný a obnovuje se pomocí pg_restore:

docker compose exec -T db pg_dump -U umami -d umami -Fc > umami-$(date +%F).dump

Naplánujte tento příkaz na serveru alespoň jednou denně, exporty, které se hromadí, třiďte a kopii posílejte jinam. Uložené na disku serveru se tyto exporty dostanou i do jeho nočních záloh.

Obnova

1. Zastavte Umami a databázi nechte běžet: docker compose stop umami.
2. Obnovte export do databáze s nahrazením stávajících objektů.
3. Spusťte Umami znovu a ověřte, že vaše weby a jejich statistiky jsou na místě.

docker compose stop umami
docker compose exec -T db pg_restore -U umami -d umami --clean --if-exists < umami-YYYY-MM-DD.dump
docker compose start umami

Toto cvičení čas od času zopakujte na kopii: tak ověříte, že záloha funguje.

Aktualizace

Dokumentace uvádí dva příkazy, ze složky se souborem compose.yaml. Databáze zůstává ve svém svazku:

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

Při restartu kontejner sám použije migrace schématu. Verze 3.4.0 ze 17. září 2026 jich přinesla dvě, pro anotace a klíče API; verze 3.4.1 z 23. října 2026 žádnou. Po velké aktualizaci, jako byl přechod na verzi 3, navrhuje dokumentace spustit v PostgreSQL ANALYZE, aby přehledy znovu získaly svou rychlost:

docker compose exec db psql -U umami -d umami -c "ANALYZE;"

• Poznámky k vydání říkají, co každá verze mění. Verze 3.4.1 je bezpečnostní oprava, která aktualizuje Next.js a základní obraz Node.js; její poznámky žádají každou instanci ve vlastním hostingu, aby aktualizovala opětovným stažením obrazu.
• Z verze 2 na MySQL: verze 3 už MySQL nepodporuje. Průvodce migrací projektu přenese data na PostgreSQL ve verzi 2.19.0, před aktualizací na verzi 3.
• Samotný PostgreSQL: ponechte značku postgres:15-alpine ze souboru. Přechod na novou hlavní verzi PostgreSQL vyžaduje export a obnovu, nebo pg_upgrade.

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í; Umami 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.