What is Umami — Modern Privacy-Focused Website Analytics?

Umami is an open-source, privacy-focused analytics platform and Google Analytics alternative with real-time dashboards, event tracking, and multi-site support.

Is Umami — Modern Privacy-Focused Website Analytics free to use?

Yes. Umami — Modern Privacy-Focused Website Analytics is freely available on TokRepo. Check the Source & Thanks section on the asset page for the specific open-source license.

How do I install Umami — Modern Privacy-Focused Website Analytics?

Visit the asset page on TokRepo and click "Copy for agent" to get the installation instructions. Most assets can be installed with a single command.

Umami — Modern Privacy-Focused Website Analytics

What Umami Does

Umami provides comprehensive analytics across web and product metrics:

Real-time Dashboard: Live visitor count, page views, sessions, and geographic distribution
Page Analytics: Detailed per-page metrics with entry/exit tracking and flow visualization
Custom Events: Track button clicks, form submissions, signups, purchases, and any user interaction
User Journey: Session replay, funnel analysis, and conversion path tracking
Audience Segmentation: Filter by country, device, browser, OS, referrer, and custom properties
UTM Tracking: Campaign attribution with source, medium, campaign, term, and content parameters
Multi-site: Manage unlimited websites from a single dashboard with team sharing

Architecture

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Your Site   │────▶│  Umami       │────▶│  PostgreSQL  │
│  (Tracker)   │     │  (Next.js)   │     │  or MySQL    │
└──────────────┘     └──────┬───────┘     └──────────────┘
                            │
                     ┌──────┴───────┐
                     │  Dashboard   │
                     │  (React UI)  │
                     └──────────────┘

Installation

Docker Compose (Recommended)

services:
  umami:
    image: ghcr.io/umami-software/umami:postgresql-latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://umami:umami@db:5432/umami
      DATABASE_TYPE: postgresql
      APP_SECRET: your-random-secret
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: umami
    volumes:
      - umami-db:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U umami"]
      interval: 5s
      timeout: 5s
      retries: 5

volumes:
  umami-db:

docker compose up -d
# Login: admin / umami

One-Click Deploy

Umami supports one-click deployment to:

Vercel: Connect GitHub repo → auto-deploy with PostgreSQL (Neon/Supabase)
Railway: Template-based deploy with built-in PostgreSQL
DigitalOcean: App Platform with managed database

Tracking Setup

Basic Page Tracking

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

The tracking script is only 2KB gzipped and loads asynchronously — zero impact on page performance.

Custom Event Tracking

// Track button click
umami.track('signup-click', { plan: 'pro', source: 'landing' });

// Track form submission
umami.track('contact-form', {
  type: 'enterprise',
  company: 'Acme Corp'
});

// Track page view with custom data
umami.track({ url: '/virtual-page', title: 'Custom Page' });

React/Next.js Integration

import Script from 'next/script';

export default function RootLayout({ children }) {
  return (
    <html>
      <head>
        <Script
          defer
          src="https://analytics.yourdomain.com/script.js"
          data-website-id="your-website-id"
        />
      </head>
      <body>{children}</body>
    </html>
  );
}

API & Integrations

REST API

# Authenticate
TOKEN=$(curl -s -X POST https://analytics.yourdomain.com/api/auth/login 
  -H "Content-Type: application/json" 
  -d '{"username":"admin","password":"umami"}' | jq -r '.token')

# Get website stats
curl "https://analytics.yourdomain.com/api/websites/{id}/stats?startAt=1704067200000&endAt=1706745600000" 
  -H "Authorization: Bearer $TOKEN"

# Get page views
curl "https://analytics.yourdomain.com/api/websites/{id}/pageviews?startAt=1704067200000&endAt=1706745600000&unit=day" 
  -H "Authorization: Bearer $TOKEN"

Umami vs Plausible

Feature	Umami	Plausible
License	MIT	AGPL-3.0
Stack	Next.js + PostgreSQL	Elixir + ClickHouse
Custom events	Rich props	Basic props
User journey	Funnels + paths	Goals only
Product analytics	Yes (cohorts, segments)	Basic
Team management	Yes	Yes
API	Full REST API	Stats API
Script size	2KB	<1KB

FAQ

Q: Umami or Plausible? A: If you only need clean traffic stats, Plausible is lighter. If you need product analytics features (user segmentation, funnel analysis, user journeys), Umami is more comprehensive. Umami's MIT license is also more permissive.

Q: PostgreSQL or MySQL? A: PostgreSQL is recommended. Both are supported, but Umami's core development targets PostgreSQL, with better community support and documentation.

Q: Can it handle high-traffic sites? A: Yes. Umami uses efficient aggregation queries — a single instance can handle millions of daily page views. For very large sites, scale horizontally with multiple Umami instances and database read replicas.

Umami — Modern Privacy-Focused Website Analytics

What Umami Does

Architecture

Installation

Docker Compose (Recommended)

One-Click Deploy

Tracking Setup

Basic Page Tracking

Custom Event Tracking

React/Next.js Integration

API & Integrations

REST API

Umami vs Plausible

FAQ

Fuente y agradecimientos

Discusión

Activos relacionados

Mathesar — Open-Source Database Interface for PostgreSQL

Livebook — Interactive Notebooks for Elixir

Nango — Open-Source Platform for Product API Integrations