umami
Privacy-first web and product analytics for traffic, campaigns, visitor behavior, conversions, retention, and revenue.
- Stars
- 40k
- Forks
- 8.5k
- Last update
- 4 Nov 2026
Overview
Umami brings website traffic and product analytics into one platform, with events, funnels, journeys, retention, and revenue reports. It works without cookies or automatic collection of personal data, and can run on your own infrastructure or Umami Cloud.
Who it's for
Tech stack
Features and benefits
Key features
- Pageviews, visitors, referrers, locations, devices, and real-time activity
- UTM campaign tracking and conversion attribution
- Custom events for clicks, form submissions, signups, and downloads
- Visitor journeys, session replays, and heatmaps
- Goals and funnels to identify conversion drop-off points
- Segments, cohorts, and retention reports
- Event values and revenue reports
- Boards, teams, and shared website statistics
- API access and an official read-only MCP server
- Cookie-free analytics without cross-site tracking or automatic personal data collection
Why it helps in Pakistan
- Compare marketing channels using traffic and conversion data.
- Find where visitors abandon important website flows.
- Understand which audiences return to your website or product.
- Keep control over where analytics data lives by self-hosting.
- Bring traffic, behavior, and revenue reporting into one place.
Pakistan use cases
- 01
A Pakistani online shop can track product-page visits and checkout events to locate funnel drop-offs.
- 02
A Lahore marketing agency can compare UTM campaigns and share website statistics with clients.
- 03
A Karachi software startup can measure signup events and returning visitor cohorts.
- 04
An Islamabad training provider can track course-page visits and enquiry form submissions.
Requirements
- Hardware
- A server; CPU, RAM, and storage sizing: Check the official docs
- Operating system
- Check the official docs
- Skills
- Command-line package installation and application builds for source installationPostgreSQL connection configuration and environment filesWebsite tracking-script installationDocker Compose for the Docker method
- Accounts needed
- PostgreSQL database credentials for source installationUmami Cloud account if using managed hostingUmami API key if enabling MCP access
Setup guide
Commands are copied from the project's README and official docs.
- 1
Get the project
Rungit clone https://github.com/umami-software/umami.git, thencd umami. The repository provides a Docker Compose file. - 2
Check Docker prerequisites and configuration
Check the official docsNot fully covered in the README. Check the official docs before running this step.
- 3
Start with Docker Compose
Rundocker compose up -d. This runs Umami with a PostgreSQL database. The separately documented image download command isdocker pull docker.umami.is/umami-software/umami:latest. - 4
Start collecting analytics
Once Umami is running, add your website, install the tracking script, and open the website dashboard.
Works with
MCP clients: Claude, ChatGPT, and Cursor
The official MCP server offers read-only analytics tools and respects website and team permissions. For self-hosting, set MCP_ENABLED=1 and authenticate with an API key generated under Settings → API keys.
Stripe, Paddle, Polar, Dodo Payments, WooCommerce, and Lemon Squeezy
Connect these payment sources to Umami Cloud. Payments and refunds sync automatically every hour into revenue reports.
Build custom reports and integrations using access to websites, events, sessions, reports, and more.
Use a reverse proxy to pass web-server requests to the running Umami application.
What it costs
| Software | Free to self-host under the MIT licence. |
|---|---|
| Hosting | As a general budgeting estimate, a small VPS usually costs about $5-20 per month; check current prices. The sources do not specify RAM or CPU requirements, so confirm sizing and database costs in the official docs. |
| Paid cloud option | Umami Cloud provides managed hosting, updates, backups, and scaling. The docs offer free account creation; pricing is not stated in the supplied sources. |
FAQ
Is Umami free to self-host?
Yes. The open-source project uses the MIT licence. You still need infrastructure to run the application and PostgreSQL.
Does Umami use cookies or collect personal data?
It works without cookies, cross-site tracking, or automatic collection of personal data. Any data you choose to send, such as distinct IDs or event properties, remains your responsibility.
What does a source installation require?
The README requires Node.js 18.18+ and PostgreSQL v12.14+, and uses pnpm to install, build, and start the application.
Can I connect an AI assistant?
Yes. The official MCP server supports Claude, ChatGPT, Cursor, and other MCP clients. Self-hosted MCP is disabled by default and requires MCP_ENABLED=1 plus an Umami API key.
Are payment-provider connections available for self-hosting?
The supplied homepage documents payment-provider connections specifically for Umami Cloud. It does not establish their availability for self-hosted installations.
Troubleshooting
The source build cannot connect to the database.
Check DATABASE_URL in the .env file, database credentials, and PostgreSQL version v12.14+. Inspect build logs and see the official docs.
The running application is not accessible publicly.
The default address is http://localhost:3000. Check the application port and configure a web-server reverse proxy or change the port as described in the README; see the official docs.
Two-factor authentication is unavailable.
Set TWO_FACTOR_ENCRYPTION_KEY to a 64-character hex string. The README documents openssl rand -hex 32 to generate one. Two-factor authentication cannot be required until this key is set.
The MCP endpoint is unavailable or authentication fails.
MCP is disabled by default. Set MCP_ENABLED=1 to enable /mcp, then authenticate with an API key generated under Settings → API keys.
Official links
Get it set up for you
Don't want to install it yourself? A Jugaad maker can set up umami for your business. Payment is held in Safe Deal until it works.
No maker offers a setup gig for this yet. Post a request and makers will quote.
Related tools
excalidraw
by excalidraw
An open-source whiteboard for hand-drawn diagrams and wireframes, with offline use and collaboration on Excalidraw.com.
- A Lahore software agency sketche…
- A Karachi retailer draws an orde…
- An Islamabad teaching team creat…
plane
by makeplane
Plane is an open-source project management tool for tracking tasks, running cycles, organizing docs, and planning product roadmaps.
- A Lahore software house can trac…
- A Karachi digital agency can div…
- An Islamabad startup can manage…
cal.diy
by calcom
MIT-licensed scheduling with calendar integrations, booking pages and APIs, recommended only for personal, non-production self-hosting.
- A developer in Lahore can test a…
- A student in Karachi can use a p…
- A freelancer in Islamabad can ev…
Built by umami-software and contributors on GitHub. All credit goes to the authors. GitHub stats refresh daily. Jugaad does not host, copy or sell this code.
Is this your project?
