Umami is a modern, privacy-focused alternative to Google Analytics. https://umami.is
Find a file
Mike Cao 28c9c7d3ec Fix Select component usage by removing items prop and render functions.
Replace render function children with mapped ListItem elements and remove
the unsupported items prop across all Select instances.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 02:46:38 -08:00
.github Merge pull request #3910 from kkhys/fix/ja-jp-breakdown 2025-12-20 21:39:29 -08:00
.husky Card mode for tables. 2025-10-14 13:04:14 -07:00
cypress Add test for updating a website with only shareId 2025-08-19 14:43:42 +00:00
db update CH view to account for new event types 2025-10-02 10:18:13 -07:00
docker Reformatted files with biome. 2025-11-22 22:42:42 -08:00
podman Fixed typo in README.md 2025-04-17 19:08:25 +02:00
prisma Merge branch 'dev' into boards 2026-02-05 20:05:25 -08:00
public Merge pull request #3884 from XahidEx/patch-2 2026-01-06 17:48:29 -08:00
scripts Merge branch 'dev' into boards 2026-02-05 20:05:25 -08:00
src Fix Select component usage by removing items prop and render functions. 2026-02-06 02:46:38 -08:00
.dockerignore chore: exclude seed scripts from Docker builds 2025-12-02 20:25:25 +03:00
.gitignore Merge branch 'dev' into boards 2026-02-05 20:05:25 -08:00
.stylelintrc.json Updated filter bar. 2025-04-02 23:18:03 -05:00
app.json Changed HASH_SALT to APP_SECRET. 2022-12-27 21:38:23 -08:00
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 add api-testing to cypress tests 2025-03-12 10:32:54 -07:00
docker-compose.yml Added check for REDIS_URL. Closes #3677. 2025-11-10 21:08:55 -08:00
Dockerfile Fixed Docker build. 2025-12-03 23:53:22 -08:00
jest.config.ts Fix test. 2025-03-31 22:49:34 -05:00
LICENSE Updated packages. 2022-12-26 20:50:55 -08:00
netlify.toml Adds @netlify/plugin-nextjs package & fixed dashboard link id 2022-10-25 15:01:49 +01:00
next-env.d.ts Updated packages. 2026-02-05 20:29:40 -08:00
next.config.ts Code cleanup. 2026-02-05 19:46:16 -08:00
package.components.json Responsive everything. 2025-10-16 02:42:13 -07:00
package.json Rename SideMenu to NavMenu, fix tooltips, and update react-zen. 2026-02-06 01:58:55 -08:00
pnpm-lock.yaml Rename SideMenu to NavMenu, fix tooltips, and update react-zen. 2026-02-06 01:58:55 -08:00
pnpm-workspace.yaml Replaced __dirname usage. 2025-04-29 09:53:11 -07:00
postcss.config.js Switched to type: module. 2025-04-29 14:36:52 -07:00
prisma.config.ts Updated prisma. 2025-11-21 21:35:11 -08:00
README.md Fix formatting for Docker compose instructions 2025-12-04 00:37:13 -08:00
rollup.tracker.config.js Switched to type: module. 2025-04-29 14:36:52 -07:00
tsconfig.json Updated packages. 2026-02-05 20:29:40 -08:00
tsconfig.prisma.json Fixed outputs. 2025-09-01 16:17:55 -07:00
tsup.config.js Export metrics components. 2025-09-03 17:16:03 -07:00

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