Jugaad
Jugaad Tool MITIntermediateBusiness AppsFree

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

Website owners and online businessesMarketing teams and agenciesProduct teams and software startupsDevelopers managing self-hosted analytics

Tech stack

TypeScriptNode.jsPostgreSQLpnpmDockerDocker Compose

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. 1

    Get the project

    Run git clone https://github.com/umami-software/umami.git, then cd umami. The repository provides a Docker Compose file.
  2. 2

    Check Docker prerequisites and configuration

    Check the official docs

    Not fully covered in the README. Check the official docs before running this step.

  3. 3

    Start with Docker Compose

    Run docker compose up -d. This runs Umami with a PostgreSQL database. The separately documented image download command is docker pull docker.umami.is/umami-software/umami:latest.
  4. 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.

  • Umami API

    Build custom reports and integrations using access to websites, events, sessions, reports, and more.

  • NGINX

    Use a reverse proxy to pass web-server requests to the running Umami application.

What it costs

SoftwareFree to self-host under the MIT licence.
HostingAs 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 optionUmami 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.

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.

Post a setup request Paid through Safe Deal

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?