umami-software/umami

What is it?

Key features

• 01Tracks traffic, campaigns, user behavior, conversions and revenue in one dashboard.
• 02Does not use cookies.
• 03Can be self-hosted or used through the Umami cloud service.
• 04Runs on Node.js with PostgreSQL as the database.
• 05Ships with Docker images and a Docker Compose setup.
• 06Supports optional two-factor authentication and API keys.

Use cases

• Measuring website traffic while keeping visitor data on your own server.
• Replacing Google Analytics on sites where cookie consent banners are unwanted.
• Tracking campaign performance and conversions for marketing teams.
• Running a self-hosted analytics stack for internal or client projects.

Quick start

1. 1

   Clone the source code from GitHub

   git clone https://github.com/umami-software/umami.git
2. 2

   Enter the project directory and install packages with pnpm

   cd umami && pnpm install
3. 3

   Create an .env file with DATABASE_URL pointing to your PostgreSQL database, then build the application

   pnpm run build
4. 4

   Start the application (runs on http://localhost:3000 by default)

   pnpm run start

Things to know

• !Requires a PostgreSQL database (v12.14+) and Node.js 18.18+ for source installs.
• !The build creates a default login with username admin and password umami, which should be changed.

Topics

FAQ

What is umami?

Privacy-first web analytics platform that tracks traffic, campaigns, behavior, conversions and revenue without cookies, self-hosted or in the cloud. Umami is an open-source web analytics platform built around user privacy. It collects traffic, campaign, behavior, conversion and revenue data in a single dashboard, and it does not use cookies, so it aims to be a lighter alternative to Google Analytics-style tracking.

Is umami free to use? What license does it have?

umami is open source under the MIT license. Check the license terms before using it in commercial products.

Is umami still maintained?

Actively maintained. The last commit to umami was on Oct 20, 2026.

What can I use umami for?

Measuring website traffic while keeping visitor data on your own server. Replacing Google Analytics on sites where cookie consent banners are unwanted. Tracking campaign performance and conversions for marketing teams. Running a self-hosted analytics stack for internal or client projects.

How do I install umami?

Clone the source code from GitHub: git clone https://github.com/umami-software/umami.git Enter the project directory and install packages with pnpm: cd umami && pnpm install Create an .env file with DATABASE_URL pointing to your PostgreSQL database, then build the application: pnpm run build Start the application (runs on http://localhost:3000 by default): pnpm run start

Where can I get umami?

The source code and installation instructions are on GitHub: https://github.com/umami-software/umami