Umami op engem Managed VPS hosten: Är Webstatistiken op Ärem Server

Wat Umami mécht

Umami ass eng Open-Source-Plattform fir Web- a Produktstatistiken. Seng Dokumentatioun beschreift en Tool, dat Traffic, Kampagnen, d’Verhale vun de Besucher, Conversiounen, Retentioun an Ëmsaz zesummebréngt, vum éischte Besuch bis zu de Resultater, déi fir Är Entreprise zielen. Et ass an TypeScript op Next.js geschriwwen, a seng Docker-Image leeft ënner engem Kont ouni Privilegien.

• D’Acquisitioun: Säitenopruff, Besucher, Referrer, Länner, Apparater an d’Aktivitéit an Echtzäit, mat UTM-Kampagnen, kuerze Linken an Tracking-Pixelen.
• D’Verhalen: personaliséiert Evenementer, Parcoursen, Opzeechnunge vu Sessiounen, Heatmaps, Segmenter, Kohorten a Retentioun.
• D’Conversioun: Ziler, Funnelen, Attributioun an Ëmsazverfollegung pro Säit a pro Kampagne.
• D’Deelen: Tableauen, Equippen, eng ëffentlech Deelungsadress, eng API an e MCP-Server, nëmme fir ze liesen, fir Ären KI-Assistent.
• Modern Siten: d’FAQ seet, datt Umami d’Navigatioun an de Single-Page-Applikatioune vu sech aus verfollegt, ouni zousätzlech Astellung.

Eng eenzeg Instanz verfollegt e puer Websäiten: all Säit kritt hir eege ID an hiren eegenen Tracking-Skript, an Är Kolleegen orientéiere sech iwwer Konten an Equippen.

Wat d’MIT-Lizenz erlaabt

Umami gëtt ënner der MIT-Lizenz publizéiert, am Numm vun Umami Software, Inc. Si gëtt, gratis, d’Recht, d’Software ze notzen, ze kopéieren, z’änneren, ze fusionéieren, ze publizéieren, ze verdeelen, ënnerzelizenzéieren a Kopie vun hir ze verkafen. Dir kënnt en also fir Är Entreprise a fir d’Websäite vun Äre Clienten lafe loossen, ouni eng Lizenz ze kafen.

Hir eenzeg Bedingung: de Copyright-Hiweis an de Hiweis op d’Erlaabnes ginn mat all Kopie oder all wesentlechen Deel vun der Software mat. Wéi all MIT-Lizenz liwwert si d’Software „as is“, also esou wéi se ass, ouni Garantie.

Cookien a perséinlech Donnéeën: wat de Projet seet

D’Dokumentatioun stellt Umami als Statistiken ouni Cookien duer, ouni Tracking iwwer verschidde Siten ewech an ouni automatesch Erfaassung vu perséinlechen Donnéeën. Selwer gehost, hält en Är Statistiken op Ärem eegene Server: Dir entscheet, wou se leien a wéi laang se bleiwen.

Dräi Astellunge vum Tracking-Skript ginn, wann Dir wëllt, nach méi wäit: data-exclude-search hëlt d’Sichparameteren aus den erfaassten Adressen eraus, data-exclude-hash hëlt den Hash eraus, an data-do-not-track schalt d’Tracking fir d’Browser aus, déi d’Preferenz Do Not Track weisen. D’Dokumentatioun preziséiert, datt dës lescht Astellung eleng keng komplett Léisung fir d’Gestioun vun der Zoustëmmung ass.

Wann Dir ugemellt Besucher mat data-distinct-id oder umami.identify() identifizéiert, recommandéiert d’Dokumentatioun eng intern Benotzer-ID oder en Hash amplaz vun enger E-Mail-Adress: de Wäert ass am HTML vun der Säit ze liesen.

D’Installatioun mat Docker Compose a PostgreSQL

De Repository liwwert eng docker-compose.yml, déi Umami a seng PostgreSQL-Datebank start. Zënter der Versioun 3 ass PostgreSQL déi eenzeg ënnerstëtzt Datebank, mindestens an der Versioun 12.14, an d’Dokumentatioun recommandéiert, se op d’UTC-Zäitzon ze stellen. Op engem Server, wou Docker installéiert ass, erstellt Dir en Dossier a fänkt mat senge Geheimnisser un, zoufälleg mat openssl generéiert, wéi d’Dokumentatioun et virschléit:

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

Leet dann dës compose.yaml dernieft. Si follegt dem Fichier vum Projet an der Versioun 3.4.1, mat zwou Ännerungen: d’Geheimnisser kommen aus dem Fichier .env, an de Port ass nëmmen op 127.0.0.1 publizéiert.

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: déi eenzeg obligatoresch Variabel, d’Verbindungsadress vun der Datebank. D’hexadezimaalt Passwuert kënnt esou eran, wéi et ass; e Passwuert mat Spezialzeeche géif d’Prozent-Kodéierung verlaangen.
• APP_SECRET: eng zoufälleg Zeechekette, déi d’Authentifiséierungs-Tokens ofséchert, eenzegaarteg fir all Installatioun. Am Code vun der Versioun 3.4.1 geet si och an d’Berechnung vun de Sessiouns-IDen an: haalt se stabil.
• TWO_FACTOR_ENCRYPTION_KEY: 64 hexadezimal Zeechen, déi d’Geheimnisser vun der Zwee-Faktor-Authentifiséierung verschlësselen. Ouni dëse Schlëssel kann keen d’Zwee-Faktor-Authentifiséierung aktivéieren.
• Beim Start kontrolléiert de Container d’Verbindung an d’Versioun vun der Datebank, a setzt dann d’Migratioune vum Schema selwer ëm. Beim éischte Start erstellt en d’Tabellen an de Kont admin. D’Sond /api/heartbeat äntwert {"ok":true}, soubal Umami prett ass.
• Den Tag latest follegt der leschter publizéierter Versioun. D’Registry vum Projet publizéiert och Versiounstags, wéi 3.4.1, fir déi Versioun ze fixéieren, déi Dir lafe loosst.

D’Installatiounsdokumentatioun gëtt keng Zuel fir Aarbechtsspäicher oder Prozessor un. D’Gréisst hänkt vum Traffic vun de verfollegte Websäiten of an dem Volumen vun den Donnéeën, déi Dir behaalt. Op engem Managed VPS beschreift eis Äre Gebrauch, a mir recommandéieren Iech déi passend Gréisst.

HTTPS: de Reverse Proxy

Umami lauschtert iwwer HTTP um Port 3000, an d’Dokumentatioun schléit vir, en hannert Ärem Webserver ze servéieren, iwwer e Reverse Proxy. Gitt him seng eege Subdomain, wéi stats.example.com, déi mat A- an AAAA-Enregistrementer op de Server weist. Fir Umami ënner engem Pfad ze servéieren, brauch een BASE_PATH, eng Variabel, déi beim Bauen vun der Applikatioun gelies gëtt: mat der publizéierter Image ass d’Subdomain den direkte Wee.

De Proxy muss och d’Adress vum Besucher weiderginn. Umami liest se aus den Headeren, déi en kritt, ënner anerem X-Real-IP an X-Forwarded-For: domat ënnerscheet en d’Besucher a lokaliséiert hiert Land. Wann Äre Proxy en aneren Header benotzt, gëtt CLIENT_IP_HEADER him säin Numm.

Mat Caddy

Caddy kritt d’Zertifikat vu Let’s Encrypt a schalt HTTPS vu sech aus an. Seng Direktiv reverse_proxy setzt X-Forwarded-For standardméisseg: dës dräi Zeilen duergoen.

stats.example.com {
  reverse_proxy 127.0.0.1:3000
}

Mat Nginx a Certbot

Dëse Block hëlt d’Nginx-Beispill aus der Umami-Dokumentatioun op, um Port 80, fir Certbot HTTPS ariichten ze loossen:

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 setzt duerno d’Zertifikat a këmmert sech drëms, et ze erneieren:

sudo certbot --nginx

Déi éischt Umeldung: den Admin-Kont an d’Zwee-Faktor-Authentifiséierung

Wann Umami seng Datebank erstellt, mécht en en Administrateurskont op: Benotzernumm admin, Passwuert umami. D’Dokumentatioun freet, dëst Passwuert bei der éischter Umeldung z’änneren.

1. Mécht Är HTTPS-Adress op a mellt Iech mat admin an umami un.
2. Mécht Settings iwwer de Profilknäppchen an der Säiteleescht op, dann Profile, a klickt op Change password.
3. Aktivéiert am Reiter Security d’Zwee-Faktor-Authentifiséierung: scannt de QR-Code mat Ärer Authentifiséierungs-App, gitt de sechszifferege Code an, a leet dann déi zéng Reservecoden op enger sécherer Plaz of, well se nëmmen eemol ugewise ginn.

• D’Zwee-Faktor-Authentifiséierung verlaangen: en Administrateur kann se fir déi ganz Instanz, fir ee Benotzer oder fir eng Equipe verlaangen, vun den Administratiounssäiten aus.
• D’Versich: no fënnef falsche Coden sinn nei Versich fir 15 Minutte gespaart.
• D’Konte vun Ärer Equipe: d’Administratiounssäite verwalten d’Benotzer, d’Websäiten an d’Equippe vun der ganzer Instanz.

Haalt TWO_FACTOR_ENCRYPTION_KEY mat Äre Backups: d’Dokumentatioun warnt, datt de Verloscht oder d’Ännerung vun dësem Schlëssel déi gespäichert Geheimnisser onliesbar mécht, an all Benotzer muss sech dann nei fir d’Zwee-Faktor-Authentifiséierung aschreiwen.

Eng Websäit an hiren Tracking-Skript derbäisetzen

1. Klickt an Websites op Add website.
2. Gitt der Websäit en Numm, an dann hiren Domainnumm: Umami benotzt en, fir Är eege Säiten aus der Lëscht vun de Referrer erauszefilteren.
3. Mécht Edit op dëser Websäit op a kopéiert de Code aus der Sektioun Tracking code.
4. Setzt en an de <head> vun Äre Säiten, a besicht dann Är Websäit: d’Donnéeën erschéngen direkt am Tableau de bord.

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

• Näischt ze gesinn? D’Dokumentatioun schléit de Reiter Netzwierk vun den Entwécklerwerkzäicher vum Browser vir: d’Ufroen un Är Instanz sollten ouni Feeler erausgoen.
• Next.js: setzt de Code mat der Komponent next/script derbäi, amplaz mat enger einfacher <script>-Balise.
• data-domains limitéiert d’Tracking op Är Produktiounsdomainen, wat Är Testëmfelder aus de Statistiken eraushält.
• Är eege Besicher ginn Websäit fir Websäit ausgeschloss, vun der Browserkonsole aus, mat localStorage.setItem('umami.disabled', 1).

En eegenen Numm fir de Skript

E puer Reklammeblocker blockéieren alles, wat no Statistike gesäit. Selwer gehost, gëtt Umami schonn vun Ärer eegener Domain aus servéiert, an zwou Variabele ginn nach méi wäit: TRACKER_SCRIPT_NAME gëtt dem Skript en aneren Numm wéi script.js, an COLLECT_API_ENDPOINT benennt den Endpunkt fir d’Erfaassung ëm, amplaz /api/send. De Skript rifft dann den neien Endpunkt vu sech aus op; op Äre Säiten ännert just d’Quell vum Tracking-Code.

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

Nëtzlech Astellungen

Dës Ëmfeldvariabele kommen an de Service umami vun der compose.yaml, an duerno erstellt docker compose up -d de Container nei, fir se z’iwwerhuelen:

D’Backups

Alles, wat Umami behält, läit a senger PostgreSQL-Datebank: Konten, Websäiten, Equippen a Statistiken. Exportéiert se all Dag an direkt virun all Aktualiséierung: selwer gehost, ginn dës Donnéeën ouni Zäitlimit behalen. Niewent der Datebank hält de Fichier .env d’Geheimnisser, déi se notzbar maachen:

D’Datebank exportéieren, wärend se leeft

pg_dump mécht e kohärenten Export, wärend d’Datebank benotzt gëtt. De personaliséierte Format, -Fc, ass kompriméiert a gëtt mat pg_restore restauréiert:

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

Plangt dëse Befehl um Server op d’mannst eemol am Dag, sortéiert d’Exporter, déi sech opstapelen, a schéckt eng Kopie anzwousch anescht hin. Um Disk vum Server geluecht, kommen dës Exporter och an seng Backups vun der Nuecht.

Restauréieren

1. Stoppt Umami a loosst d’Datebank lafen: docker compose stop umami.
2. Restauréiert den Export an d’Datebank, andeems déi bestoend Objeten ersat ginn.
3. Start Umami nei, a kontrolléiert dann, datt Är Websäiten an hir Statistiken do sinn.

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

Widderhuelt dësen Exercice vun Zäit zu Zäit, op enger Kopie: esou kontrolléiert Dir, datt eng Backup funktionéiert.

D’Aktualiséierungen

D’Dokumentatioun gëtt zwee Befeeler, aus dem Dossier vun der compose.yaml. D’Datebank bleift an hirem Volume:

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

Beim Neistart setzt de Container d’Migratioune vum Schema selwer ëm. D’Versioun 3.4.0 vum 17. September 2026 hat der zwou, fir d’Annotatiounen an d’API-Schlësselen; d’Versioun 3.4.1 vum 23. Oktober 2026 huet keng. No engem grousse Versiounssprong, wéi dem Iwwergang op d’Versioun 3, schléit d’Dokumentatioun vir, ANALYZE an PostgreSQL auszeféieren, fir datt d’Tableaue erëm séier ginn:

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

• D’Release Notes soen, wat all Versioun ännert. D’Versioun 3.4.1 ass eng Sécherheetskorrektur, déi Next.js an d’Basisimage vun Node.js aktualiséiert; hir Notize froen all selwer gehost Instanz, z’aktualiséieren, andeems se d’Image nei eroflueden.
• Vun enger Versioun 2 op MySQL aus: d’Versioun 3 ënnerstëtzt MySQL net méi. De Migratiounsguide vum Projet bréngt d’Donnéeën op der Versioun 2.19.0 op PostgreSQL, virum Wiessel op d’Versioun 3.
• PostgreSQL selwer: behaalt den Tag postgres:15-alpine aus dem Fichier. De Wiessel op eng nei Haaptversioun vu PostgreSQL verlaangt en Export an eng Restauratioun, oder pg_upgrade.

Wien mécht wat op engem Managed VPS

Selwer hosten heescht, de Server zousätzlech zur Applikatioun ze halen. Op engem Managed VPS huelen eis Equippen de Server an d’Hand a verfollegen Är Instanz proaktiv; Umami bleift Är Software, mat senge Astellungen an Donnéeën.

Wann Dir léiwer wëllt, datt eis Equippen an der Applikatioun selwer intervenéieren, gëtt dës Prestatioun op Stonnebasis oder pauschal verrechent, mat engem Käschtevirschlag, deen Iech virun der Interventioun matgedeelt gëtt.