# Umami: je eerste stappen

> Inloggen, een website toevoegen, het trackingscript plakken en Umami actueel houden.

Source: https://veldhost.eu/nl/docs/umami-getting-started

Umami gekozen? Je site is geleverd met Umami op de Node.js-runtime — eenvoudige, privacyvriendelijke statistieken zonder cookies, dus zonder toestemmingsbanner ervoor.

## Wat er wordt geïnstalleerd

- **Umami**, gebouwd vanaf de vastgepinde release-tag van de officiële repository (de commit wordt vóór de build gecontroleerd), draaiend als systemd-service op Node.js 22 met een eigen **PostgreSQL**-database in je container.
- Het standaardaccount `admin` met het bekende standaardwachtwoord al **vervangen** door een gegenereerd wachtwoord; telemetrie en updatecontroles uit.
- De instellingen staan in `.env` in de codemap van je site (tabblad Bestanden): `DATABASE_URL` en `APP_SECRET`.

## Eerste keer inloggen

1. Je sitepagina toont het inlogadres (`/login`), de gebruikersnaam `admin` en het gegenereerde wachtwoord — we tonen het 7 dagen, dus sla het nu op.
2. Log in en stel je eigen wachtwoord in onder **Profile → Change password**.
3. Voeg een website toe onder **Settings → Websites → Add website** en kopieer het trackingscript — `<script defer src="https://je-umami/script.js" data-website-id="…">` — naar de site die je wilt meten.
4. Nodig collega's uit onder **Settings → Users**; met een Team delen meerdere mensen websites.

## Bijwerken

- Druk eerst op **Nu back-uppen** op het tabblad Bestanden.
- Haal de volgende release-tag op in de codemap (SSH: `git fetch --tags && git checkout vX.Y.Z`) en start een deploy: `npm install`, `npm run build` (dat de databasemigraties uitvoert) en een herstart. De build vraagt een paar minuten ongeveer 1,5 GB; op het Starter-pakket lenen we dat voor de eerste installatie — voor updates vraag je support of gebruik je een Pro-pakket.

## Beperkingen

- Umami draait prima in een Starter-container (768 MB) voor een handvol sites; miljoenen events per maand vragen om Pro.
- Landherkenning gebruikt de GeoLite2-database die tijdens de build wordt gedownload; die wordt pas bij de volgende build ververst.