NewOut Plane raises funding, backed by Maza VenturesRead the announcement
Analytics

Umami

Overview

Deploy Umami on Out Plane — a simple, fast, privacy-focused web analytics tool and self-hosted alternative to Google Analytics. Umami is GDPR, CCPA, and PECR compliant by default because it does not use cookies, does not collect personal data, and does not track users across websites. The lightweight tracking script is under 2KB.

Umami provides a real-time dashboard with page views, unique visitors, bounce rate, session duration, referrers, browser and OS breakdowns, and custom event tracking. It supports multiple websites from a single installation and offers a shareable dashboard feature. Self-hosting on Out Plane means your analytics data is never shared with third parties.

Ideal for privacy-conscious websites, GDPR-compliant businesses, developers who want lightweight analytics without cookie banners, and anyone looking to replace Google Analytics with a self-hosted, privacy-first solution.


Umami Self Hosted: Deploy Umami Analytics with Docker

Updated

Umami is an open source, cookie-free web analytics app that keeps all of its data in PostgreSQL. To run Umami self-hosted on Out Plane, deploy the official Docker image ghcr.io/umami-software/umami:3.4.1 on port 3000, connect a managed PostgreSQL database, and set DATABASE_URL and APP_SECRET. It needs no volume. The first login is admin with the password umami, so change it at once.

This guide maps Umami's official install docs to Out Plane. Out Plane runs a self-hosted Umami for its own website. For other apps, browse the templates.

What You Need

  • One app for Umami. The image runs a Next.js server. The smallest size, op-20 (0.5 vCPU, 512 MB), is the template's listed minimum and suits a few low-traffic sites. Move to op-34 (1 vCPU, 2 GB) if the dashboard slows down.
  • A managed PostgreSQL database. Umami supports PostgreSQL only, version 12.14 or newer. Out Plane offers versions 14 to 18, with 17 as the default. See Databases.
  • No volume. Events, sessions, users and settings all live in the database, so the container keeps nothing on disk.
  • Two secrets. APP_SECRET secures login tokens. TWO_FACTOR_ENCRYPTION_KEY must be 64 hex characters and is required before anyone can turn on two-factor sign-in. Generate each with openssl rand -hex 32.

Redis is optional. Umami recommends it for high traffic or several Umami instances.

From Umami Docker Compose to Out Plane

Umami's official docker-compose.yml defines two services. Each one maps to one Out Plane resource.

Compose serviceWhat it runsOn Out Plane
umamighcr.io/umami-software/umami:latest on port 3000An image app with port 3000, HTTP, public
dbpostgres:15-alpine with a umami-db-data volumeA managed PostgreSQL database

The compose file sets DATABASE_URL, APP_SECRET and TWO_FACTOR_ENCRYPTION_KEY on the app. You set the same three. Pin a version tag such as 3.4.1 instead of latest, so a redeploy never upgrades Umami by surprise.

Deploy Umami on Out Plane

  1. In the console, open Create → Database. Name it, for example umami-db. Pick Europe (Frankfurt), the region nearest the app, which runs in Germany. Keep version 17 and select Create database. The region cannot change later.
  2. When the database is ready, open it. In the Connection panel, copy the psql URI. Connections require SSL, so add ?sslmode=require if the URI does not already include it.
  3. Open Create → Application and choose the Image source. Enter ghcr.io/umami-software/umami:3.4.1.
  4. Give the app a Name such as umamistats. Names use letters and numbers only, 5 to 45 characters, and cannot change later.
  5. In Compute, pick op-20 and 1 instance. In Ports, set 3000 as a public HTTP port.
  6. In Environment variables, paste this block with your own values:
bash
DATABASE_URL=postgresql://USER:PASSWORD@HOST/DATABASE?sslmode=require
APP_SECRET=PASTE_OUTPUT_OF_openssl_rand_hex_32
TWO_FACTOR_ENCRYPTION_KEY=PASTE_A_SECOND_openssl_rand_hex_32
DISABLE_TELEMETRY=1
  1. Leave Volumes empty and select Deploy app. On first start, the container runs its database migrations, creates the tables and creates the admin account.
  2. Open https://umamistats-3000-acme.outplane.app, using your own app name and team slug. Sign in as admin with umami, then open Settings → Profile → Change password. Turn on two-factor sign-in under Security.
  3. Go to Websites → Add website, enter a name and your domain, then copy the snippet under Edit → Tracking code into your site's <head>.

Prefer the terminal? outplane app create creates and deploys in one call.

bash
outplane db create umami-db --region FRANKFURT_REGION_ID   # IDs are listed in: outplane db create --help
outplane db get umami-db                                   # wait until it reports active
outplane app create umamistats \
  --image ghcr.io/umami-software/umami:3.4.1 \
  --port 3000:http:public --size op-20 \
  --env DATABASE_URL="$(outplane db url umami-db)" \
  --env APP_SECRET="$(openssl rand -hex 32)" \
  --env TWO_FACTOR_ENCRYPTION_KEY="$(openssl rand -hex 32)"

Umami Docker Environment Variables

Umami reads its settings from environment variables. These are the ones worth knowing on Out Plane:

VariableWhat it does
DATABASE_URLPostgreSQL connection string. The only required variable.
APP_SECRETRandom string that secures login tokens. Use a unique value per installation.
TWO_FACTOR_ENCRYPTION_KEY64 hex characters. Required before any user can enable 2FA.
TRACKER_SCRIPT_NAMEServes the tracker under another name than script.js, which helps with some ad blockers.
COLLECT_API_ENDPOINTMoves the collection endpoint away from /api/send, for the same reason.
IGNORE_IPComma-separated IPs and CIDR ranges to leave out, such as your office.
DISABLE_TELEMETRYTurns off Umami's anonymous usage telemetry.
PRIVATE_MODEBlocks all external network calls, which also hides website icons.

Change them under Settings → Environment with Save & deploy. Three Umami-specific notes:

  • Do not set HOSTNAME. Umami's docs list it, but Out Plane reserves it and sets it for each instance.
  • BASE_PATH will not work here. It is a build-time variable, so the prebuilt image ignores it. Serve Umami from its own subdomain instead of a subfolder.
  • Check the database timezone. Umami recommends running PostgreSQL in UTC. Connect with psql and run SHOW timezone; before real traffic arrives.

Custom Domain and HTTPS

Add the domain after the first deploy succeeds. Open Domains → Add domain, enter a bare host such as stats.example.com, then pick umamistats and port 3000. Open the DNS dialog. A subdomain gets a CNAME record pointing to domains-management.outplane.app. An apex domain gets an A record at @ with the value the console shows. DNS takes 5 to 30 minutes, and HTTPS is issued automatically once it resolves, as the Domains guide explains.

From the CLI, run outplane domain add stats.example.com --app umamistats --port 3000, then outplane domain dns stats.example.com. Then point your tracker at the new host:

html
<script defer src="https://stats.example.com/script.js" data-website-id="YOUR-WEBSITE-ID"></script>

If you use heatmaps, your site must allow the Umami origin in a Content-Security-Policy: frame-ancestors header. Otherwise the page preview stays blank.

Updates and Backups

Image apps never update on their own. Read the Umami releases, then open the app's Deployments tab, select Deploy and enter the full new image reference. From the terminal:

bash
outplane deploy create umamistats --image ghcr.io/umami-software/umami:NEW_VERSION --wait

The container applies pending database migrations when it starts. After a major upgrade, such as the move to v3, Umami's update guide says to run ANALYZE; in psql so dashboard queries stay fast.

Managed PostgreSQL includes automated backups. A new version can change the schema, so also keep a dump you control before each upgrade:

bash
pg_dump "$(outplane db url umami-db)" -Fc -f umami-$(date +%F).dump

Self-hosted Umami keeps data until you delete it, so the database grows with your traffic.

What Umami Costs on Out Plane

Compute is billed per instance-minute. op-20 costs $0.0000694 a minute, about $3.00 for a 30-day month. Managed PostgreSQL adds $6.00 a month, and Umami needs no volume. That is $9.00 of usage.

  • Starter, $9 a month, includes $9 of usage and one managed database, so this setup costs $9 in total.
  • Pro, $29 a month, includes $15 of usage, so it stays at $29 and allows up to 5 instances per app.
  • On op-34 ($18.00 a month), usage is $24. That is $24 on Starter or $38 on Pro.

Starter and Pro both start with a 14 day free trial. Bandwidth, SSL and custom domains are not billed. Full rates are on the pricing page.

Self-Hosted Umami vs Umami Cloud

Umami Cloud pricing, checked on 2026-11-11: Hobby is free for 1 website and 100K events a month with 6 months of retention. Pro is $20 a month for 1 million events, up to 20 websites and 2 years of retention. Session replays and heatmaps need Business at $200 a month.

Umami's Cloud comparison says self-hosted installs get the same analytics, plus replays from v3.1 and heatmaps from v3.2. Only email reports are Cloud only. Self-hosting fits when you track many sites, want no retention limit, or want replays without the Business plan. For more apps that run this way, see the best Docker containers to self-host.

FAQ

Is self-hosted Umami free?

The software is MIT licensed, so you pay only for hosting. On Out Plane, op-20 plus managed PostgreSQL is about $9 a month, covered by Starter's included usage. Starter starts with a 14 day free trial.

Does Umami Cloud have more features than self-hosted Umami?

Mostly no. Both share the same analytics features. Email reports are Cloud only, while replays and heatmaps are included when self-hosted.

What is the default Umami login?

Username admin, password umami, created when Umami first sets up its database. Change it right after your first login.

Can I run Umami with MySQL?

No. Umami supports PostgreSQL only, version 12.14 or newer. Out Plane's managed PostgreSQL offers versions 14 to 18.

Umami's tracker sets no cookies. Whether your site needs a notice depends on the other services it uses, as Umami's FAQ notes.



Start deploying in minutes

Connect your GitHub repository and deploy your first application today. Start with a 14-day free trial.

Start 14-day free trial