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 toop-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_SECRETsecures login tokens.TWO_FACTOR_ENCRYPTION_KEYmust be 64 hex characters and is required before anyone can turn on two-factor sign-in. Generate each withopenssl 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 service | What it runs | On Out Plane |
|---|---|---|
umami | ghcr.io/umami-software/umami:latest on port 3000 | An image app with port 3000, HTTP, public |
db | postgres:15-alpine with a umami-db-data volume | A 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
- 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. - When the database is ready, open it. In the Connection panel, copy the
psqlURI. Connections require SSL, so add?sslmode=requireif the URI does not already include it. - Open Create → Application and choose the Image source. Enter
ghcr.io/umami-software/umami:3.4.1. - Give the app a Name such as
umamistats. Names use letters and numbers only, 5 to 45 characters, and cannot change later. - In Compute, pick
op-20and 1 instance. In Ports, set3000as a public HTTP port. - In Environment variables, paste this block with your own values:
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- Leave Volumes empty and select Deploy app. On first start, the container runs its database migrations, creates the tables and creates the
adminaccount. - Open
https://umamistats-3000-acme.outplane.app, using your own app name and team slug. Sign in asadminwithumami, then open Settings → Profile → Change password. Turn on two-factor sign-in under Security. - 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.
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:
| Variable | What it does |
|---|---|
DATABASE_URL | PostgreSQL connection string. The only required variable. |
APP_SECRET | Random string that secures login tokens. Use a unique value per installation. |
TWO_FACTOR_ENCRYPTION_KEY | 64 hex characters. Required before any user can enable 2FA. |
TRACKER_SCRIPT_NAME | Serves the tracker under another name than script.js, which helps with some ad blockers. |
COLLECT_API_ENDPOINT | Moves the collection endpoint away from /api/send, for the same reason. |
IGNORE_IP | Comma-separated IPs and CIDR ranges to leave out, such as your office. |
DISABLE_TELEMETRY | Turns off Umami's anonymous usage telemetry. |
PRIVATE_MODE | Blocks 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_PATHwill 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:
<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:
outplane deploy create umamistats --image ghcr.io/umami-software/umami:NEW_VERSION --waitThe 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:
pg_dump "$(outplane db url umami-db)" -Fc -f umami-$(date +%F).dumpSelf-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.
Does Umami need a cookie banner?
Umami's tracker sets no cookies. Whether your site needs a notice depends on the other services it uses, as Umami's FAQ notes.