Umami — Modern Privacy-Focused Website Analytics

What it is

Umami is an open-source, privacy-focused website analytics platform. It provides real-time dashboards, event tracking, multi-site support, and custom reporting without cookies, personal data collection, or GDPR consent banners. Umami is designed as a Google Analytics replacement for teams that prioritize user privacy.

Umami targets website owners, developers, and organizations that need analytics without the privacy concerns and complexity of Google Analytics. It collects only essential metrics: page views, referrers, browsers, devices, and countries.

How it saves time or tokens

Umami's lightweight tracking script (under 2kB) loads faster than Google Analytics, improving page performance. No cookie consent banners are needed because Umami does not use cookies or track personal data. Self-hosting eliminates data sharing with third parties. The real-time dashboard shows current visitors without waiting for data processing delays.

How to use

1. Deploy Umami:

git clone https://github.com/umami-software/umami.git
cd umami
cp .env.example .env
# Set DATABASE_URL in .env
npm install
npx prisma migrate deploy
npm run build
npm start

1. Open http://localhost:3000, log in with admin/umami, and change the default password.

1. Add your website and copy the tracking script to your pages:

<script
  defer
  src="https://your-umami-instance.com/script.js"
  data-website-id="your-website-id">
</script>

Example

# docker-compose.yml for Umami
services:
  umami:
    image: ghcr.io/umami-software/umami:postgresql-latest
    ports:
      - '3000:3000'
    environment:
      DATABASE_URL: postgresql://umami:password@postgres:5432/umami
    depends_on:
      - postgres
  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: password
    volumes:
      - umami-db:/var/lib/postgresql/data
volumes:
  umami-db:

Related on TokRepo

• Self-Hosted Tools — Self-hosted alternatives to SaaS products
• SEO Tools — Analytics and SEO measurement

This tool integrates with standard development workflows and requires minimal configuration to get started. It is available as open-source software with documentation and community support through the official repository. The project follows semantic versioning for stable releases.

For teams evaluating this tool, the key advantage is reducing manual work in repetitive tasks. The automation provided by the built-in features means less custom code to maintain and fewer integration points to manage. This translates directly to lower maintenance costs and faster iteration cycles.

Common pitfalls

• Change the default admin password immediately after first login; the default credentials (admin/umami) are well-known.
• The tracking script must be served from the same domain or a trusted domain to avoid ad blocker interference.
• Umami does not provide the full feature set of Google Analytics (no conversion funnels, no user-level tracking); evaluate whether the simplified metrics meet your needs.