Hostati Umami na Managed VPS-u: vaša web-analitika na vašem poslužitelju

Što radi Umami

Umami je platforma otvorenog koda za web-analitiku i analitiku proizvoda. Njegova dokumentacija opisuje alat koji objedinjuje promet, kampanje, ponašanje posjetitelja, konverzije, zadržavanje i prihode, od prvog posjeta do rezultata koji su važni vašem poslovanju. Napisan je u TypeScriptu na Next.js-u, a njegova Docker slika radi pod računom bez povlastica.

• Pridobivanje: pregledi stranica, posjetitelji, izvori prometa, zemlje, uređaji i aktivnost u stvarnom vremenu, s UTM kampanjama, kratkim poveznicama i pikselima za praćenje.
• Ponašanje: prilagođeni događaji, putovi kretanja, snimke sesija, toplinske karte, segmenti, kohorte i zadržavanje.
• Konverzija: ciljevi, lijevci, atribucija i praćenje prihoda po stranici i po kampanji.
• Dijeljenje: ploče, timovi, javni URL za dijeljenje, API i MCP poslužitelj samo za čitanje za vašeg AI asistenta.
• Moderna web-mjesta: FAQ navodi da Umami sam prati navigaciju između stranica u jednostraničnim aplikacijama, bez dodatne postavke.

Jedna instanca prati više web-mjesta: svako dobiva vlastiti ID i skriptu za praćenje, a vaši se kolege snalaze zahvaljujući računima i timovima.

Što dopušta licenca MIT

Umami je objavljen pod licencom MIT, u ime tvrtke Umami Software, Inc. Ona besplatno daje pravo na upotrebu, kopiranje, izmjenu, spajanje, objavljivanje, distribuciju, podlicenciranje i prodaju primjeraka softvera. Stoga ga možete pokretati za svoju tvrtku i za web-mjesta svojih klijenata, bez kupnje licence.

Njezin jedini uvjet: napomena o autorskim pravima i napomena o dopuštenju idu uz sve primjerke ili bitne dijelove softvera. Kao i svaka licenca MIT, softver daje „kakav jest”, bez jamstva.

Kolačići i osobni podaci: što kaže projekt

Dokumentacija Umami predstavlja kao analitiku bez kolačića, bez praćenja između web-mjesta i bez automatskog prikupljanja osobnih podataka. Hostan na vlastitom poslužitelju, vašu analitiku čuva na vašem poslužitelju: vi odlučujete gdje se nalazi i koliko dugo ostaje.

Tri postavke skripte za praćenje idu i dalje, ako želite: data-exclude-search uklanja parametre pretraživanja iz zabilježenih URL-ova, data-exclude-hash uklanja dio iza znaka #, a data-do-not-track isključuje praćenje za preglednike koji iskazuju postavku Do Not Track. Dokumentacija napominje da ta posljednja postavka sama po sebi nije cjelovito rješenje za upravljanje privolama.

Ako prijavljene posjetitelje identificirate s data-distinct-id ili umami.identify(), dokumentacija preporučuje interni ID korisnika ili hash umjesto adrese e-pošte: vrijednost se može pročitati u HTML-u stranice.

Instalacija s Docker Composeom i PostgreSQL-om

Repozitorij isporučuje docker-compose.yml koji pokreće Umami i njegovu bazu PostgreSQL. Od inačice 3 PostgreSQL je jedina podržana baza, najmanje u inačici 12.14, a dokumentacija preporučuje da je postavite na vremensku zonu UTC. Na poslužitelju s instaliranim Dockerom izradite mapu i počnite s njezinim tajnama, nasumično generiranima s openssl, kako predlaže dokumentacija:

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

Zatim pokraj nje stavite ovaj compose.yaml. Slijedi datoteku projekta u inačici 3.4.1, s dvije izmjene: tajne dolaze iz datoteke .env, a port je objavljen samo 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: jedina obavezna varijabla, niz za povezivanje s bazom. Heksadecimalna lozinka upisuje se kakva jest; lozinka s posebnim znakovima zahtijevala bi postotno kodiranje.
• APP_SECRET: nasumični niz koji štiti autentifikacijske tokene, jedinstven za svaku instalaciju. U kodu inačice 3.4.1 ulazi i u izračun ID-ova sesija: neka ostane nepromijenjen.
• TWO_FACTOR_ENCRYPTION_KEY: 64 heksadecimalna znaka koja šifriraju tajne dvofaktorske autentifikacije. Bez njega nitko ne može uključiti dvofaktorsku autentifikaciju.
• Pri pokretanju kontejner provjerava vezu s bazom i njezinu inačicu, a zatim sam primjenjuje migracije sheme. Pri prvom pokretanju izrađuje tablice i račun admin. Provjera /api/heartbeat odgovara {"ok":true} kada je Umami spreman.
• Oznaka latest prati posljednje objavljeno izdanje. Registar projekta objavljuje i oznake inačica, poput 3.4.1, kojima fiksirate onu koju pokrećete.

Dokumentacija o instalaciji ne navodi potrebnu memoriju ni procesor. Veličina ovisi o prometu praćenih web-mjesta i o količini podataka koje čuvate. Na Managed VPS-u opišite nam svoju upotrebu, a mi vam preporučujemo odgovarajuću veličinu.

HTTPS: obrnuti proxy

Umami sluša preko HTTP-a na portu 3000, a dokumentacija predlaže da ga poslužujete iza svojeg web-poslužitelja, preko obrnutog proxyja. Dodijelite mu vlastitu poddomenu, poput stats.example.com, koja pokazuje na poslužitelj putem A i AAAA zapisa. Posluživanje Umamija pod putanjom ide preko BASE_PATH, varijable koja se čita pri izradi aplikacije: uz objavljenu sliku poddomena je izravan put.

Proxy mora prosljeđivati i adresu posjetitelja. Umami je čita iz zaglavlja koja prima, među njima X-Real-IP i X-Forwarded-For: koristi je za razlikovanje posjetitelja i određivanje njihove zemlje. Ako vaš proxy koristi drugo zaglavlje, navodi ga CLIENT_IP_HEADER.

S Caddyjem

Caddy sam pribavlja certifikat Let’s Encrypt i uključuje HTTPS. Njegova direktiva reverse_proxy prema zadanim postavkama postavlja X-Forwarded-For: ova tri retka su sve što vam treba.

stats.example.com {
  reverse_proxy 127.0.0.1:3000
}

S Nginxom i Certbotom

Ovaj blok preuzima primjer za Nginx iz dokumentacije Umamija, uz slušanje na portu 80 kako bi Certbot postavio HTTPS:

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 zatim postavlja certifikat i brine se za njegovu obnovu:

sudo certbot --nginx

Prva prijava: administratorski račun i dvofaktorska autentifikacija

Kada izradi svoju bazu, Umami otvara administratorski račun: korisničko ime admin, lozinka umami. Dokumentacija traži da tu lozinku promijenite pri prvoj prijavi.

1. Otvorite svoju HTTPS adresu i prijavite se s admin i umami.
2. Otvorite Settings preko gumba profila na bočnoj traci, zatim Profile, i kliknite Change password.
3. Na kartici Security uključite dvofaktorsku autentifikaciju: skenirajte QR kod svojom aplikacijom za autentifikaciju, unesite šesteroznamenkasti kod, a zatim deset pričuvnih kodova spremite na sigurno mjesto, jer se prikazuju samo jednom.

• Obavezna dvofaktorska autentifikacija: administrator je može zahtijevati za cijelu instancu, za jednog korisnika ili za jedan tim, sa stranica administracije.
• Pokušaji: pet pogrešnih kodova blokira daljnje pokušaje na 15 minuta.
• Računi vašeg tima: stranice administracije upravljaju korisnicima, web-mjestima i timovima cijele instance.

Čuvajte TWO_FACTOR_ENCRYPTION_KEY sa svojim sigurnosnim kopijama: dokumentacija upozorava da gubitak ili promjena tog ključa spremljene tajne čini nečitljivima, a svaki se korisnik tada mora ponovno upisati u dvofaktorsku autentifikaciju.

Dodavanje web-mjesta i njegove skripte za praćenje

1. U izborniku Websites kliknite Add website.
2. Dajte web-mjestu naziv, a zatim njegovu domenu: Umami je koristi kako bi vaše vlastite stranice izostavio s popisa izvora prometa.
3. Otvorite Edit na tom web-mjestu i kopirajte kod iz odjeljka Tracking code.
4. Zalijepite ga u <head> svojih stranica, a zatim posjetite svoje web-mjesto: podaci se odmah pojavljuju na nadzornoj ploči.

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

• Ništa se ne prikazuje? Dokumentacija predlaže karticu mreže u razvojnim alatima preglednika: zahtjevi prema vašoj instanci trebaju odlaziti bez pogrešaka.
• Next.js: kod dodajte komponentom next/script umjesto obične oznake <script>.
• data-domains ograničava praćenje na vaše produkcijske domene, čime vaša testna okruženja ostaju izvan statistike.
• Vaši vlastiti posjeti isključuju se za svako web-mjesto posebno, iz konzole preglednika, s localStorage.setItem('umami.disabled', 1).

Vlastiti naziv skripte

Neki blokatori oglasa blokiraju sve što nalikuje analitici. Uz hostanje na vlastitom poslužitelju Umami se već poslužuje s vaše domene, a dvije varijable idu i dalje: TRACKER_SCRIPT_NAME skripti daje drugi naziv umjesto script.js, a COLLECT_API_ENDPOINT preimenuje krajnju točku za prikupljanje, umjesto /api/send. Skripta tada sama poziva novu krajnju točku; na vašim se stranicama mijenja samo izvor koda za praćenje.

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

Korisne postavke

Ove varijable okruženja idu u uslugu umami datoteke compose.yaml, a zatim docker compose up -d ponovno izrađuje kontejner kako bi ih uzeo u obzir:

Sigurnosne kopije

Sve što Umami čuva nalazi se u njegovoj bazi PostgreSQL: računi, web-mjesta, timovi i analitika. Izvezite je svaki dan i neposredno prije svakog ažuriranja: uz hostanje na vlastitom poslužitelju ti se podaci čuvaju bez vremenskog ograničenja. Uz bazu, datoteka .env sadrži tajne koje je čine upotrebljivom:

Izvoz baze dok radi

pg_dump izrađuje dosljedan izvoz dok se baza koristi. Prilagođeni format, -Fc, sažet je i vraća se s pg_restore:

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

Tu naredbu planirajte na poslužitelju barem jednom dnevno, povremeno prorijedite izvoze, koji se nakupljaju, i kopiju pošaljite na drugo mjesto. Čuvani na disku poslužitelja, ti izvozi ulaze i u njegove noćne sigurnosne kopije.

Vraćanje

1. Zaustavite Umami, a bazu ostavite da radi: docker compose stop umami.
2. Vratite izvoz u bazu, uz zamjenu postojećih objekata.
3. Ponovno pokrenite Umami, a zatim provjerite jesu li vaša web-mjesta i njihova analitika na mjestu.

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

Tu vježbu povremeno ponovite, na kopiji: tako provjeravate da sigurnosna kopija radi.

Ažuriranja

Dokumentacija daje dvije naredbe, iz mape s datotekom compose.yaml. Baza ostaje u svojem volumenu:

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

Pri ponovnom pokretanju kontejner sam primjenjuje migracije sheme. Inačica 3.4.0 od 17. rujna 2026. donijela ih je dvije, za bilješke i API ključeve; inačica 3.4.1 od 23. listopada 2026. ne donosi nijednu. Nakon velike nadogradnje, poput prelaska na inačicu 3, dokumentacija predlaže pokretanje naredbe ANALYZE u PostgreSQL-u kako bi nadzorne ploče vratile svoju brzinu:

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

• Bilješke o izdanju navode što svaka inačica mijenja. Inačica 3.4.1 hitni je sigurnosni ispravak koji ažurira Next.js i osnovnu sliku Node.js; njezine bilješke traže od svake samostalno hostane instance da se nadogradi ponovnim preuzimanjem slike.
• S inačice 2 na MySQL-u: inačica 3 više ne podržava MySQL. Vodič za migraciju projekta podatke premješta na PostgreSQL na inačici 2.19.0, prije nadogradnje na inačicu 3.
• Sam PostgreSQL: zadržite oznaku postgres:15-alpine iz datoteke. Prelazak na novu glavnu inačicu PostgreSQL-a traži izvoz i vraćanje ili pg_upgrade.

Tko što radi na Managed VPS-u

Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; Umami ostaje vaš softver, sa svojim postavkama i podacima.

Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.