Self-host Umami

updated Sep 2026deployed by usprices checked · Jul 2026Install verified on Ubuntu 26.04 · Sep 2026 · how we test

We earn commissions when you shop through the links below. Full disclosure →

Privacy-focused, cookieless web analytics with funnels, journeys, retention, session replays and heatmaps in the free MIT build. Two containers (Next.js + PostgreSQL) and one script tag to install.

Key facts

CategoryWeb analytics

LicenseMIT

StackNext.js, PostgreSQL

Min RAM1024 MB

Official imageyes

Measured idle RAM165 MB

Difficulty

Sourcegithub.com/umami-software/umami

Websiteumami.is

Our recommendation

Pick Umami when you want analytics you can install in minutes and forget: MIT, one Next.js container plus PostgreSQL, cookieless, and a v3 line (v3.4.0 as of September 2026) whose free build covers funnels, journeys, retention, revenue, segments and cohorts, tracking links and pixels (3.0), session replays and Web Vitals (3.1) and heatmaps (3.2), with a managed cloud beside it rather than behind a paywall. Upstream's compose is the whole install; our 1 GB floor is our estimate for app and database together. The one hard requirement is the database: v3 is PostgreSQL only.

Follow the Umami deploy guide →

What you need

Any VPS with at least 1024 MB of RAM
A domain you control — most self-hosted setups need HTTPS in front of them
Under an hour if you've used Docker before

Where to host itaffiliate disclosure

Hetzner Cloudrun it on

From $23.59/mo · 2 vCPU / 4 GB / 80 GB · EU + US

Get Hetzner Cloud

Kamaterafree trial

From $4/mo · 1 vCPU / 1 GB / 20 GB · US + EU + Asia

Start free on Kamatera →

DigitalOceanalso works on

From $6/mo · 1 vCPU / 1 GB / 25 GB · US + EU + Asia

Deploy on DigitalOcean →

Paid link — we earn a commission if you shop through it.

Install

Run these commands on your server:

# Umami — official compose (app + PostgreSQL)
git clone https://github.com/umami-software/umami umami
cd umami
# set a strong APP_SECRET in docker-compose.yml, then:
docker compose up -d  #  →  http://SERVER_IP:3000  (admin / umami)

deploy guideHow to Deploy Umami on a VPS vps picksBest VPS for self-hostingbenchmarked quarterly · re-priced monthly

What you take on

Umami is low-drama to operate; its defaults are what you need to change:

non-negotiablev3 dropped MySQL. "Umami v3 no longer supports MySQL as a database option, only PostgreSQL" (v3.0.0 release notes), with a migration guide for v2 MySQL installs; the install docs list PostgreSQL >= 12.14 and, for source installs, Node.js >= 18.18.

non-negotiableEvery install starts with admin / umami; the docs say to "Change the default password immediately after your first login." Upstream's compose ships APP_SECRET: replace-me-with-a-random-string — generate one with openssl rand -hex 32 — and 2FA "is unavailable and cannot be required" until TWO_FACTOR_ENCRYPTION_KEY is a 64-character hex string.

non-negotiableUmami "collects completely anonymous telemetry data" and checks for new versions by default; set DISABLE_TELEMETRY=1 and DISABLE_UPDATES=1 if that matters to you.

non-negotiableAd blockers know script.js and /api/send. The documented fix is TRACKER_SCRIPT_NAME and COLLECT_API_ENDPOINT to rename both — do it before you publish the snippet to your sites.

non-negotiableThe 1 GB floor is our estimate; upstream publishes no RAM figure. Updates are docker compose pull && docker compose up --force-recreate -d.