selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Umami logo

Self-host Umami

v3.5.0

Privacy-first web and product analytics without cookies

ReleaseOpen SourceMIT
Docker ComposeCompose file & guide
docker compose up -d
Updated4 days ago
LanguageTypescript
Setup difficultyEasy
Stars
40 179
Port
3000 (Umami web UI and API (Node/Next.js server))
Requires
Node.js, PostgreSQL
Docker
docker.umami.is/umami-software/umami
Umami screenshot 1Umami screenshot 2Umami screenshot 3Umami screenshot 4Umami screenshot 5Umami screenshot 6Umami screenshot 7

What is Umami?

Umami is an MIT-licensed, open-source analytics platform for websites and products that tracks acquisition, behaviour, conversion, retention and revenue without cookies or personally identifiable data. Reports include dashboards with pageviews and bounce metrics, breakdowns, goals, funnels, journeys, retention and cohorts, UTM attribution, revenue tracking, realtime data, session replays and click/scroll heatmaps, plus teams, boards and share links. It ships a REST API and, from v3.4, an optional read-only MCP endpoint for AI assistants. Two-factor authentication is available once an encryption key is configured. Operators install it from source with Node.js and PostgreSQL, or with the provided Docker Compose file and prebuilt images; it listens on port 3000 behind a reverse proxy. Redis is an optional cache and session store. Self-hosting includes the same analytics features as the paid hosted service, but scheduled email reports are only available in Umami Cloud.

Umami alternatives

Should you self-host Umami?

Umami scores 85/100 on selfhost.directory (how scoring works) and ranks #1 of 22 in Web analytics. It has 40 179 GitHub stars, +839 in the last 30 days.

It shipped 13 stable releases in the past year. The latest, v3.5.0, came out on 12 November 2026. New versions land roughly every 3 weeks.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Plausible Analytics (79/100, 29 865 stars). Umami scores higher overall. See Umami vs Plausible Analytics side by side.

Features

  • Cookieless privacy-first tracking
  • Custom event tracking
  • Email ReportsUmami Cloud only; not available in the self-hosted version.
  • Funnel analysis
  • Goals conversion tracking
  • HeatmapsAvailable since v3.2.0 in self-hosted.
  • MCP server for AI assistantsSelf-hosted v3.4 or later, disabled by default until MCP_ENABLED is set.
  • REST API
  • Retention and cohorts
  • Revenue Tracking
  • Session replaysIncluded in self-hosted v3.1 or later; replays are stored for 30 days.
  • Two-factor authenticationUnavailable and cannot be required until TWO_FACTOR_ENCRYPTION_KEY is set.
  • User journey reports
  • UTM and marketing attribution

Umami README

Umami Logo

Umami

Umami is an open-source web and product analytics platform. Understand acquisition, behavior, conversion, and retention with privacy-first analytics — no cookies, self-hosted or in the cloud.

How to install Umami

Install Umami with Docker Compose

Environment variables
DATABASE_URL, APP_SECRET, TWO_FACTOR_ENCRYPTION_KEY
docker compose up -d

The shipped compose file starts Umami together with a PostgreSQL database on port 3000.

How to configure Umami

  • DATABASE_URLConnection string for your database. This is the only required variable.
  • APP_SECRETA random string used to secure authentication tokens. Each installation should have a unique value.
  • CLIENT_IP_HEADERHTTP header to check for the client's IP address, useful behind a proxy using non-standard headers.
  • COLLECT_API_ENDPOINT/api/sendSend metrics to a location different than the default /api/send, to help avoid some ad blockers.
  • CORS_MAX_AGE86400How many seconds a CORS preflight should last. Default is 24 hours.

Umami releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Where can I go for help if I have problems or want to request a feature?

Use GitHub Discussions for questions, GitHub issues for bugs and feature requests, or the community Discord.

Can I query Umami from an AI assistant?

Yes, there is an official read-only MCP server for clients such as Claude, ChatGPT and Cursor.

Does Umami support product analytics?

Yes — alongside web analytics it offers custom events, funnels, goals, journeys, retention, segments, cohorts, replays and heatmaps using the same tracker, but it has no feature flags, surveys or built-in experimentation engine.

What databases does Umami support?

Only PostgreSQL, with a minimum version of 12.14.

Can I self-host Umami?

Yes, it is open source and can run on your own infrastructure; the Installation docs describe the options.

What data does Umami collect?

Pageviews, referrer URLs, browsers, operating systems, device types and country of origin — all anonymized, with no personally identifiable information stored.

Does Umami work on a single page application (SPA)?

Yes, page navigations in SPAs are tracked automatically with no extra configuration.

Do I need to display a cookie notice to users?

No, the tracking code does not use cookies at all.

Is Umami GDPR compliant?

Yes — it collects no personally identifiable information, anonymizes everything it gathers, and never identifies or cross-site tracks users.

More in Web analytics

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…