umami Docker & Self-Hosted Deployment

GitHub

Umami is a privacy-first analytics platform. Traffic, campaigns, behavior, conversions, and revenue in one place โ€” no cookies, no surveillance, self-hosted...

RAW Compose
1. Pull Image (GHCR) docker pull ghcr.io/umami-software/umami
2. Docker Run (1-Click Launch) docker run -d --name umami -p 3000:3000 --restart always ghcr.io/umami-software/umami:latest
3. Podman Run podman run -d --name umami -p 3000:3000 --restart always ghcr.io/umami-software/umami:latest
4. Skopeo Inspect (Zero-Pull Manifest) skopeo inspect docker://ghcr.io/umami-software/umami:latest
5. ORAS Pull (OCI Artifact) oras pull ghcr.io/umami-software/umami:latest
6. Compose Deployment docker compose up -d
docker-compose.yml
Download .yml
---
services:
  umami:
    image: ghcr.io/umami-software/umami:latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://umami:umami@db:5432/umami
      APP_SECRET: replace-me-with-a-random-string
      # Required for two-factor authentication, generate with: openssl rand -hex 32
      TWO_FACTOR_ENCRYPTION_KEY: replace-me-with-a-64-character-hex-string
    depends_on:
      db:
        condition: service_healthy
    init: true
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "curl http://localhost:3000/api/heartbeat"]
      interval: 5s
      timeout: 5s
      retries: 5
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: umami
    volumes:
      - umami-db-data:/var/lib/postgresql/data
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5
volumes:
  umami-db-data: