Umami Save

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

Project README


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

Getting started

A detailed getting started guide can be found at

Installing from source


  • A server with Node.js version 12 or newer
  • A database. Umami supports MySQL and Postgresql databases.

Install Yarn

npm install -g yarn

Get the source code and install packages

git clone
cd umami
yarn install

Configure umami

Create an .env file with the following


The connection url is in the following format:

postgresql://username:[email protected]:5432/mydb

mysql://username:[email protected]:3306/mydb

Build the application

yarn build

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

Start the application

yarn 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

To build the umami container and start up a Postgres database, run:

docker compose up

Alternatively, to pull just the Umami Docker image with PostgreSQL support:

docker pull

Or with MySQL support:

docker pull

Getting updates

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

git pull
yarn install
yarn build

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

docker compose pull
docker compose up --force-recreate



Open Source Agenda is not affiliated with "Umami" Project. README Source: umami-software/umami
Open Issues
Last Commit
2 weeks ago

Open Source Agenda Badge

Open Source Agenda Rating