Umami is a modern, privacy-focused alternative to Google Analytics. https://umami.is
Find a file
Mike Cao 631cc46f7f
Some checks are pending
Node.js CI / build (push) Waiting to run
Add personal dashboard flow and per-component website selection
This introduces a user-scoped dashboard with board-style view/edit pages while keeping it unavailable in team context, and moves website targeting to component config so dashboard components can each select their own website.
2026-02-13 11:48:15 -08:00
.github Merge pull request #3910 from kkhys/fix/ja-jp-breakdown 2025-12-20 21:39:29 -08:00
.husky
cypress Add test for updating a website with only shareId 2025-08-19 14:43:42 +00:00
db
docker Reformatted files with biome. 2025-11-22 22:42:42 -08:00
podman
prisma revert prisma schema to latest, add global css for scroll-bar, fix css 2026-02-06 15:06:10 -08:00
public Add personal dashboard flow and per-component website selection 2026-02-13 11:48:15 -08:00
scripts Merge pull request #4006 from diogotcorreia/env-skip-build-geo 2026-02-09 12:49:19 -08:00
src Add personal dashboard flow and per-component website selection 2026-02-13 11:48:15 -08:00
.dockerignore chore: exclude seed scripts from Docker builds 2025-12-02 20:25:25 +03:00
.gitignore Fix tooltip sizing for websitechart 2026-02-09 11:19:04 -08:00
.stylelintrc.json
AGENTS.md docs: add AGENTS.md contributor guidance 2026-02-12 21:13:54 -08:00
app.json
biome.json Bump version 3.0.2. 2025-12-03 23:01:22 -08:00
CLAUDE.md Code cleanup. 2026-02-05 19:46:16 -08:00
cypress.config.ts
docker-compose.yml
Dockerfile Fixed Docker build. 2025-12-03 23:53:22 -08:00
jest.config.ts
LICENSE
netlify.toml
next-env.d.ts Fixed BarChart rendering in boards. 2026-02-12 18:10:04 -08:00
next.config.ts Add personal dashboard flow and per-component website selection 2026-02-13 11:48:15 -08:00
package.components.json
package.json Fixed BarChart rendering in boards. 2026-02-12 18:10:04 -08:00
pnpm-lock.yaml Fixed BarChart rendering in boards. 2026-02-12 18:10:04 -08:00
pnpm-workspace.yaml
postcss.config.js
prisma.config.ts
README.md Fix formatting for Docker compose instructions 2025-12-04 00:37:13 -08:00
rollup.tracker.config.js
tsconfig.json Updated packages. 2026-02-05 20:29:40 -08:00
tsconfig.prisma.json
tsup.config.js

Umami Logo

Umami

Umami is a simple, fast, privacy-focused alternative to Google Analytics.

GitHub Release MIT License Build Status Umami Demo


🚀 Getting Started

A detailed getting started guide can be found at umami.is/docs.


🛠 Installing from Source

Requirements

  • A server with Node.js version 18.18+.
  • A PostgreSQL database version v12.14+.

Get the source code and install packages

git clone https://github.com/umami-software/umami.git
cd umami
pnpm install

Configure Umami

Create an .env file with the following:

DATABASE_URL=connection-url

The connection URL format:

postgresql://username:mypassword@localhost:5432/mydb

Build the Application

pnpm run build

The build step will create tables in your database if you are installing for the first time. It will also create a login user with username admin and password umami.

Start the Application

pnpm run start

By default, this will launch the application on http://localhost:3000. You will need to either proxy requests from your web server or change the port to serve the application directly.


🐳 Installing with Docker

Umami provides Docker images as well as a Docker compose file for easy deployment.

Docker image:

docker pull docker.umami.is/umami-software/umami:latest

Docker compose (Runs Umami with a PostgreSQL database):

docker compose up -d

🔄 Getting Updates

To get the latest features, simply do a pull, install any new dependencies, and rebuild:

git pull
pnpm install
pnpm build

To update the Docker image, simply pull the new images and rebuild:

docker compose pull
docker compose up --force-recreate -d

🛟 Support

GitHub Twitter LinkedIn Discord