{
  "manifest_version": "1",
  "slug": "umami",
  "title": "Umami",
  "headline": "Self-host Umami analytics",
  "description": "Run Umami web analytics on exe.dev with PostgreSQL: a public tracker on your own domain, a private dashboard behind exe.dev login, nightly backups.",
  "category": "monitoring",
  "tags": [
    "web analytics",
    "google analytics alternative",
    "plausible alternative",
    "privacy",
    "gdpr",
    "postgresql",
    "docker compose"
  ],
  "url": "https://exe.dev/deploy/umami",
  "markdown_url": "https://exe-staging.dev/deploy/umami.md",
  "upstream": {
    "website": "https://umami.is",
    "source": "https://github.com/umami-software/umami",
    "docs": "https://umami.is/docs",
    "license": "MIT"
  },
  "example_vm_name": "my-umami",
  "time": "10 minutes",
  "stack": [
    {
      "name": "Umami 3",
      "detail": "ghcr.io/umami-software/umami:3, dashboard and API",
      "port": 3000
    },
    {
      "name": "PostgreSQL 18",
      "detail": "postgres:18; all your analytics data",
      "data": "~/umami/postgres"
    },
    {
      "name": "Tracker proxy",
      "detail": "nginx; the tracker script and its endpoint, nothing else",
      "port": 8000
    },
    {
      "name": "Nightly backup",
      "detail": "pg_dump from a systemd timer; keeps two weeks",
      "data": "~/umami/backups"
    }
  ],
  "access": [
    {
      "url": "https://my-umami.exe.xyz:3000/",
      "who": "private",
      "what": "The Umami dashboard, behind exe.dev login and Umami's own"
    },
    {
      "url": "https://my-umami.exe.xyz/script.js",
      "who": "public",
      "what": "The tracker and its collection endpoint, once you make the VM public"
    }
  ],
  "delivers": [
    "Umami 3 on PostgreSQL, restarted after a reboot.",
    "A private dashboard on port 3000 and a tracker-only public URL.",
    "Nightly database backups, with the secrets file beside them."
  ],
  "owner_runs_after": [
    "ssh exe.dev share set-public my-umami   # lets visitors' browsers reach the tracker"
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20Umami%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fumami.md%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-umami.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-umami.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20Umami%203%20on%20PostgreSQL%2C%20restarted%20after%20a%20reboot.%0A-%20A%20private%20dashboard%20on%20port%203000%20and%20a%20tracker-only%20public%20URL.%0A-%20Nightly%20database%20backups%2C%20with%20the%20secrets%20file%20beside%20them.%0A%0ARead%20the%20whole%20recipe%2C%20including%20closed%20details%2C%20and%20follow%20%22Install%20by%0Ahand%22%20first.%20The%20opening%20walkthrough%20is%20for%20the%20owner%20afterwards.%20Do%20not%0Arun%20the%20later%20Restore%20or%20Update%20instructions.%0AWork%20as%20exedev%20in%20~%2Fumami.%20Never%20overwrite%20an%20existing%20~%2Fumami%2F.env.%0ADo%20not%20log%20in%20to%20Umami%2C%20change%20its%20password%2C%20or%20add%20websites%3A%20the%20owner%0Adoes%20that%20in%20the%20browser.%20Leave%20public%20sharing%20off%3B%20only%20the%20owner%20can%0Aturn%20it%20on.%20Verify%20docker.service%20is%20enabled%2C%20all%20three%20containers%20are%0Arestart%20unless-stopped%20and%20healthy%20or%20up%2C%20localhost%3A3000%2Fapi%2Fheartbeat%0Aanswers%20%7B%22ok%22%3Atrue%7D%2C%20localhost%3A8000%2Fscript.js%20returns%20200%2C%20and%0Alocalhost%3A8000%2Flogin%20and%20localhost%3A8000%2Fapi%2Fwebsites%20return%20404.%20Check%0Athe%20backup%20timer%20is%20enabled%20and%20the%20first%20dump%20exists%20in%20~%2Fumami%2Fbackups.%0AFinish%20with%20the%20dashboard%20URL%20on%20port%203000%2C%20the%20default%20login%0A%28admin%20%2F%20umami%2C%20which%20Umami%20makes%20them%20replace%20at%20once%29%2C%20and%20the%20command%0Athe%20owner%20runs%20on%20their%20own%20computer%20to%20make%20the%20tracker%20public%3A%0Assh%20exe.dev%20share%20set-public%20my-umami%0A%0AFinish%20with%20the%20URLs%20I%20should%20open%20and%20these%20commands%2C%20which%20only%20I%20can%20run%2C%20from%20my%20own%20computer%20%28with%20this%20VM%27s%20name%20in%20them%29%3A%0A%20%20ssh%20exe.dev%20share%20set-public%20my-umami%20%20%20%23%20lets%20visitors%27%20browsers%20reach%20the%20tracker%0A",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/umami/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up Umami on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/umami.md from top to bottom.\n\nThe recipe's example VM name is my-umami. This VM's name is the output of `hostname`: use it wherever the recipe writes my-umami. Skip the step that creates the VM; you are on it.\n\nYou are done when all of these are true. Check each one yourself:\n- Umami 3 on PostgreSQL, restarted after a reboot.\n- A private dashboard on port 3000 and a tracker-only public URL.\n- Nightly database backups, with the secrets file beside them.\n\nRead the whole recipe, including closed details, and follow \"Install by\nhand\" first. The opening walkthrough is for the owner afterwards. Do not\nrun the later Restore or Update instructions.\nWork as exedev in ~/umami. Never overwrite an existing ~/umami/.env.\nDo not log in to Umami, change its password, or add websites: the owner\ndoes that in the browser. Leave public sharing off; only the owner can\nturn it on. Verify docker.service is enabled, all three containers are\nrestart unless-stopped and healthy or up, localhost:3000/api/heartbeat\nanswers {\"ok\":true}, localhost:8000/script.js returns 200, and\nlocalhost:8000/login and localhost:8000/api/websites return 404. Check\nthe backup timer is enabled and the first dump exists in ~/umami/backups.\nFinish with the dashboard URL on port 3000, the default login\n(admin / umami, which Umami makes them replace at once), and the command\nthe owner runs on their own computer to make the tracker public:\nssh exe.dev share set-public my-umami\n\nFinish with the URLs I should open and these commands, which only I can run, from my own computer (with this VM's name in them):\n  ssh exe.dev share set-public my-umami   # lets visitors' browsers reach the tracker\n",
    "prompt_url": "https://exe-staging.dev/deploy/umami/prompt.txt"
  },
  "updated": "2026-11-16",
  "verified": "2026-11-16",
  "related": [
    "uptime-kuma",
    "postgres",
    "nextjs",
    "docker-compose",
    "n8n-2",
    "claude-code"
  ],
  "alternatives": [
    "Google Analytics",
    "Plausible",
    "Fathom"
  ]
}
