Skip to content
MetribayДокументация на Metribay

Umami

Umami — privacy-friendly open-source analytics. Metribay reads self-hosted Umami.

What you get

Section titled “What you get”
Metric Meaning Period value
Visitors Unique visitors Exact unique visitors for the whole period, from Umami
Visits Visits (sessions) Sum of the days
Page views Page views Sum of the days

UTC days. Umami dashboard = browser TZ — single days may differ slightly; period totals align.

Before you start

Section titled “Before you start”

Server reachable:

  • HTTPS port 443,
  • public address — not private/VPN-only/IP internal.

Step 1: Create a user for Metribay

Section titled “Step 1: Create a user for Metribay”

Separate user safer than admin password in Metribay.

  1. Umami Settings → Users — user metribay, View only.

  2. Access to websites — team that owns sites.

  3. Sign in as new user — verify websites visible.

Step 2: Connect it in Metribay

Section titled “Step 2: Connect it in Metribay”

  1. Add data source → Umami.

  2. Connect an account with your own credentials:

    • Server URL: e.g. https://analytics.example.com — no /login path.
    • Username, Password.

  3. Save account and continue.

  4. Website from list (search name/domain).

  5. Add and start import.

Enter the website by hand

Section titled “Enter the website by hand”

Enter it manually — Website UUID from Settings → Websites → Edit as Website ID, e.g. 4fb7fa4c-5b46-438d-94b3-3a8fb9bc2e8b.

If collection fails

Section titled “If collection fails”

“Use a public HTTPS server URL on port 443.” Fix URL — plain https://.

Website isn’t listed. User can’t see it → Umami access, Refresh list.

Needs attention after success. Password/server → test Umami login → update connected account.

Troubleshooting.