Umami is a modern, privacy-focused alternative to Google Analytics. https://umami.is
Find a file
Mike Cao b43e7fd3a7 Hide sidebar collapse button on mobile
onItemClick is only passed on mobile, so use it to detect mobile context

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 00:37:29 -08:00
.github
.husky
cypress
db
docker
podman
prisma fix share data migration to '{"overview":true}' 2026-01-22 19:52:55 -08:00
public Merge pull request #3884 from XahidEx/patch-2 2026-01-06 17:48:29 -08:00
scripts fix tar import tar.t() to list() in build-geo 2026-01-22 18:24:43 -08:00
src Hide sidebar collapse button on mobile 2026-01-29 00:37:29 -08:00
.dockerignore
.gitignore Share page changes. 2026-01-24 02:47:09 -08:00
.stylelintrc.json
app.json
biome.json
cypress.config.ts
docker-compose.yml
Dockerfile
jest.config.ts
LICENSE
netlify.toml
next-env.d.ts
next.config.ts
package.components.json
package.json dependabot - bump tar t. 7.5.7 2026-01-28 09:49:30 -08:00
pnpm-lock.yaml dependabot - bump tar t. 7.5.7 2026-01-28 09:49:30 -08:00
pnpm-workspace.yaml
postcss.config.js
prisma.config.ts
README.md
rollup.tracker.config.js
tsconfig.json
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