Näin hostaatte Umamin Managed VPS:llä: verkkoanalytiikka omalla palvelimellanne

Mitä Umami tekee

Umami on avoimen lähdekoodin analytiikka-alusta verkkosivustoille ja tuotteille. Sen dokumentaatio kuvaa työkalun, joka kokoaa yhteen liikenteen, kampanjat, kävijöiden käyttäytymisen, konversiot, sitoutumisen ja tulot ensimmäisestä käynnistä liiketoiminnallenne tärkeisiin tuloksiin. Se on kirjoitettu TypeScriptillä Next.js:n päälle, ja sen Docker-image toimii ilman erityisoikeuksia olevalla tilillä.

• Hankinta: sivunkatselut, kävijät, viittaavat sivustot, maat, laitteet ja reaaliaikainen toiminta sekä UTM-kampanjat, lyhytlinkit ja seurantapikselit.
• Käyttäytyminen: mukautetut tapahtumat, polut, istuntojen tallenteet, lämpökartat, segmentit, kohortit ja sitoutuminen.
• Konversio: tavoitteet, suppilot, attribuutio ja tulojen seuranta sivuittain ja kampanjoittain.
• Jakaminen: näkymät, tiimit, julkinen jako-osoite, rajapinta ja vain luku -tilassa toimiva MCP-palvelin tekoälyavustajallenne.
• Modernit sivustot: usein kysytyt kysymykset kertovat, että Umami seuraa sivujen välistä siirtymistä yhden sivun sovelluksissa itsestään ilman lisäasetuksia.

Yksi instanssi seuraa useita verkkosivustoja: kukin saa oman tunnisteensa ja seurantaskriptinsä, ja kolleganne löytävät tiensä tilien ja tiimien avulla.

Mitä MIT-lisenssi sallii

Umami julkaistaan MIT-lisenssillä Umami Software, Inc. -yhtiön nimissä. Se antaa maksutta oikeuden käyttää, kopioida, muokata, yhdistää, julkaista, jakaa, alilisensoida ja myydä ohjelmiston kopioita. Voitte siis ajaa sitä yrityksellenne ja asiakkaidenne verkkosivustoille ilman ostettavaa lisenssiä.

Sen ainoa ehto: tekijänoikeusilmoitus ja lupailmoitus kulkevat kaikkien ohjelmiston kopioiden tai sen merkittävien osien mukana. Kuten mikä tahansa MIT-lisenssi, se toimittaa ohjelmiston ”sellaisenaan”, ilman takuuta.

Evästeet ja henkilötiedot: mitä projekti sanoo

Dokumentaatio esittelee Umamin analytiikkana ilman evästeitä, ilman sivustojen välistä seurantaa ja ilman henkilötietojen automaattista keräämistä. Kun hostaatte sen itse, analytiikkanne pysyy omalla palvelimellanne: te päätätte, missä tiedot ovat ja kuinka kauan ne säilyvät.

Kolme seurantaskriptin asetusta vie halutessanne pidemmälle: data-exclude-search poistaa hakuparametrit tallennetuista osoitteista, data-exclude-hash poistaa #-merkin jälkeisen osan, ja data-do-not-track poistaa seurannan käytöstä selaimilta, jotka ilmoittavat Do Not Track -asetuksen. Dokumentaatio huomauttaa, ettei viimeksi mainittu asetus yksinään ole täydellinen suostumustenhallintaratkaisu.

Jos tunnistatte kirjautuneet kävijät asetuksella data-distinct-id tai kutsulla umami.identify(), dokumentaatio suosittelee sisäistä käyttäjätunnistetta tai tiivistettä sähköpostiosoitteen sijaan: arvo on luettavissa sivun HTML-koodista.

Asennus Docker Composella ja PostgreSQL:llä

Repositorio toimittaa tiedoston docker-compose.yml, joka käynnistää Umamin ja sen PostgreSQL-tietokannan. Versiosta 3 alkaen PostgreSQL on ainoa tuettu tietokanta, vähintään versio 12.14, ja dokumentaatio suosittelee asettamaan sen UTC-aikavyöhykkeeseen. Luokaa palvelimelle, jolle Docker on asennettu, kansio ja aloittakaa sen salaisuuksista, jotka luodaan satunnaisesti openssl:llä dokumentaation ehdotuksen mukaisesti:

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

Sijoittakaa sitten sen viereen tämä compose.yaml. Se noudattaa projektin tiedostoa versiossa 3.4.1 kahdella muutoksella: salaisuudet tulevat .env-tiedostosta, ja portti julkaistaan vain osoitteessa 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: ainoa pakollinen muuttuja, tietokannan yhteysmerkkijono. Heksadesimaalinen salasana kirjoitetaan sellaisenaan; erikoismerkkejä sisältävä salasana vaatisi prosenttikoodauksen.
• APP_SECRET: satunnainen merkkijono, joka suojaa todennustunnukset ja on jokaiselle asennukselle yksilöllinen. Version 3.4.1 koodissa se on mukana myös istuntotunnisteiden laskennassa: pitäkää se muuttumattomana.
• TWO_FACTOR_ENCRYPTION_KEY: 64 heksadesimaalimerkkiä, jotka salaavat kaksivaiheisen tunnistautumisen salaisuudet. Ilman sitä kukaan ei voi ottaa kaksivaiheista tunnistautumista käyttöön.
• Käynnistyessään kontti tarkistaa tietokantayhteyden ja -version ja ajaa sitten skeeman migraatiot itse. Ensimmäisellä kerralla se luo taulut ja admin-tilin. Tarkistus /api/heartbeat vastaa {"ok":true}, kun Umami on valmis.
• Tunniste latest seuraa viimeisintä julkaistua versiota. Projektin rekisteri julkaisee myös versiotunnisteita, kuten 3.4.1, joilla ajamanne version voi kiinnittää.

Asennusdokumentaatio ei ilmoita muistin eikä suorittimen tarvetta. Koko riippuu seurattujen verkkosivustojen liikenteestä ja säilyttämienne tietojen määrästä. Managed VPS -palvelimella kertokaa meille käyttötarkoituksenne, niin suosittelemme sopivaa kokoa.

HTTPS: käänteinen välityspalvelin

Umami kuuntelee HTTP:tä portissa 3000, ja dokumentaatio ehdottaa sen tarjoamista verkkopalvelimenne takana käänteisen välityspalvelimen kautta. Antakaa sille oma aliverkkotunnus, kuten stats.example.com, joka osoittaa palvelimeen A- ja AAAA-tietueilla. Umamin tarjoaminen polun alla kulkee muuttujan BASE_PATH kautta, joka luetaan sovellusta käännettäessä: julkaistulla imagella aliverkkotunnus on suora tie.

Välityspalvelimen on myös välitettävä kävijän osoite. Umami lukee sen saamistaan otsakkeista, muun muassa otsakkeista X-Real-IP ja X-Forwarded-For: se käyttää sitä erottaakseen kävijät toisistaan ja paikantaakseen heidän maansa. Jos välityspalvelimenne käyttää muuta otsaketta, CLIENT_IP_HEADER nimeää sen.

Caddyllä

Caddy hankkii Let’s Encrypt -varmenteen ja ottaa HTTPS:n käyttöön itse. Sen reverse_proxy-direktiivi asettaa oletuksena otsakkeen X-Forwarded-For: nämä kolme riviä riittävät.

stats.example.com {
  reverse_proxy 127.0.0.1:3000
}

Nginxillä ja Certbotilla

Tämä lohko noudattaa Umamin dokumentaation Nginx-esimerkkiä ja kuuntelee porttia 80, jotta Certbot voi asentaa HTTPS:n:

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 asentaa sen jälkeen varmenteen ja huolehtii sen uusimisesta:

sudo certbot --nginx

Ensimmäinen kirjautuminen: admin-tili ja kaksivaiheinen tunnistautuminen

Luodessaan tietokantansa Umami avaa ylläpitäjän tilin: käyttäjätunnus admin, salasana umami. Dokumentaatio pyytää vaihtamaan tämän salasanan ensimmäisellä kirjautumisella.

1. Avatkaa HTTPS-osoitteenne ja kirjautukaa tunnuksilla admin ja umami.
2. Avatkaa Settings sivupalkin profiilipainikkeesta, sitten Profile, ja napsauttakaa Change password.
3. Ottakaa Security-välilehdellä käyttöön kaksivaiheinen tunnistautuminen: skannatkaa QR-koodi todennussovelluksellanne, syöttäkää kuusinumeroinen koodi ja tallentakaa sitten kymmenen varakoodia turvaan, sillä ne näytetään vain kerran.

• Kaksivaiheisen tunnistautumisen vaatiminen: ylläpitäjä voi vaatia sitä koko instanssilta, yhdeltä käyttäjältä tai yhdeltä tiimiltä ylläpitosivuilta.
• Yritykset: viisi väärää koodia lukitsee uudet yritykset 15 minuutiksi.
• Tiiminne tilit: ylläpitosivut hallitsevat koko instanssin käyttäjiä, verkkosivustoja ja tiimejä.

Säilyttäkää TWO_FACTOR_ENCRYPTION_KEY varmuuskopioidenne mukana: dokumentaatio varoittaa, että tämän avaimen menettäminen tai vaihtaminen tekee tallennetuista salaisuuksista lukukelvottomia, jolloin jokaisen käyttäjän on otettava kaksivaiheinen tunnistautuminen uudelleen käyttöön.

Verkkosivuston ja sen seurantaskriptin lisääminen

1. Napsauttakaa kohdassa Websites painiketta Add website.
2. Antakaa verkkosivustolle nimi ja sitten sen verkkotunnus: Umami käyttää sitä suodattaakseen omat sivunne pois viittaavien sivustojen luettelosta.
3. Avatkaa kyseisen verkkosivuston Edit ja kopioikaa koodi Tracking code -osiosta.
4. Liittäkää se sivujenne <head>-osioon ja käykää sitten verkkosivustollanne: tiedot näkyvät koontinäytössä heti.

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

• Eikö mitään näy? Dokumentaatio ehdottaa selaimen kehittäjätyökalujen verkkovälilehteä: instanssiinne suuntautuvien pyyntöjen pitäisi lähteä ilman virheitä.
• Next.js: lisätkää koodi next/script-komponentilla pelkän <script>-tagin sijaan.
• data-domains rajaa seurannan tuotantoverkkotunnuksiinne, mikä pitää testiympäristönne poissa tilastoista.
• Omat käyntinne jätetään pois verkkosivusto kerrallaan selaimen konsolista komennolla localStorage.setItem('umami.disabled', 1).

Oma nimi skriptille

Jotkin mainosten estäjät estävät kaiken, mikä näyttää analytiikalta. Omalla palvelimella Umami tarjotaan jo omasta verkkotunnuksestanne, ja kaksi muuttujaa vie pidemmälle: TRACKER_SCRIPT_NAME antaa skriptille muun nimen kuin script.js, ja COLLECT_API_ENDPOINT nimeää keräyspäätepisteen uudelleen polun /api/send sijaan. Skripti kutsuu sen jälkeen uutta päätepistettä itse; sivuillanne muuttuu vain seurantakoodin lähde.

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

Hyödylliset asetukset

Nämä ympäristömuuttujat sijoitetaan tiedoston compose.yaml umami-palveluun, minkä jälkeen docker compose up -d luo kontin uudelleen, jotta ne tulevat huomioon:

Varmuuskopiot

Kaikki, mitä Umami säilyttää, on sen PostgreSQL-tietokannassa: tilit, verkkosivustot, tiimit ja analytiikka. Ottakaa siitä vienti joka päivä ja juuri ennen jokaista päivitystä: omalla palvelimella nämä tiedot säilyvät ilman aikarajaa. Tietokannan rinnalla .env-tiedosto sisältää salaisuudet, jotka tekevät siitä käyttökelpoisen:

Tietokannan vienti sen ollessa käynnissä

pg_dump tekee yhtenäisen viennin tietokannan ollessa käytössä. Mukautettu muoto, -Fc, on pakattu ja palautetaan komennolla pg_restore:

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

Ajastakaa tämä komento palvelimella vähintään kerran päivässä, karsikaa vientejä, jotka kasautuvat, ja lähettäkää kopio muualle. Palvelimen levyllä säilytettyinä nämä viennit päätyvät myös sen yöllisiin varmuuskopioihin.

Palauttaminen

1. Pysäyttäkää Umami ja jättäkää tietokanta käyntiin: docker compose stop umami.
2. Palauttakaa vienti tietokantaan ja korvatkaa olemassa olevat objektit.
3. Käynnistäkää Umami uudelleen ja tarkistakaa sitten, että verkkosivustonne ja niiden analytiikka ovat paikallaan.

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

Toistakaa tämä harjoitus silloin tällöin kopiolla: näin varmistatte, että varmuuskopio toimii.

Päivitykset

Dokumentaatio antaa kaksi komentoa, ajettavaksi compose.yaml-tiedoston kansiossa. Tietokanta pysyy taltiossaan:

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

Uudelleenkäynnistyksessä kontti ajaa skeeman migraatiot itse. 17. syyskuuta 2026 julkaistu versio 3.4.0 sisälsi niistä kaksi, huomautuksille ja API-avaimille; 23. lokakuuta 2026 julkaistu versio 3.4.1 ei sisällä yhtään. Pääversion päivityksen, kuten siirtymän versioon 3, jälkeen dokumentaatio ehdottaa komennon ANALYZE ajamista PostgreSQL:ssä, jotta koontinäytöt saavat nopeutensa takaisin:

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

• Julkaisutiedot kertovat, mitä kukin versio muuttaa. Versio 3.4.1 on tietoturvakorjaus, joka päivittää Next.js:n ja Node.js-pohjaimagen; sen tiedot pyytävät jokaista omalla palvelimella toimivaa instanssia päivittämään hakemalla imagen uudelleen.
• MySQL:ää käyttävästä versiosta 2: versio 3 ei enää tue MySQL:ää. Projektin siirto-opas siirtää tiedot PostgreSQL:ään versiossa 2.19.0 ennen päivitystä versioon 3.
• PostgreSQL itse: säilyttäkää tiedoston tunniste postgres:15-alpine. Siirtyminen PostgreSQL:n uuteen pääversioon vaatii viennin ja palautuksen tai komennon pg_upgrade.

Kuka tekee mitä Managed VPS:llä

Oma hostaus vaatii palvelimen ylläpitoa sovelluksen lisäksi. Managed VPS -palvelimella tiimimme huolehtivat palvelimesta ja seuraavat instanssianne proaktiivisesti; Umami pysyy teidän ohjelmananne asetuksineen ja tietoineen.

Jos haluatte tiimiemme toimivan itse sovelluksessa, tämä palvelu laskutetaan tuntiveloituksella tai kiinteällä hinnalla, ja arvio annetaan ennen toimenpidettä.