Deploy Umami with Docker Compose

Manage the application and its services in one Compose project.

Deploy Umami

Managed deployment

  1. 1. Choose plan
  2. 2. Review order
Service plan
What’s included in Production Stack
  • Everything in Starter Deployment
  • Dedicated PostgreSQL / MySQL / ClickHouse configuration
  • Persistent database volume & storage tuning
  • Redis cache / background worker configuration
  • Automated database dump & offsite backup script (S3/R2 ready)
  • Log rotation & resource limit safeguards
Verified Recipe
Application versionSee upstream release requirements
Recipe verificationVerified with upstream standard
Database in this deployment profilePostgreSQL
CPU, RAM, and storageCheck upstream infrastructure requirements

Prerequisites

  • A host you administer and persistent storage for application data.
  • Docker Engine and the Docker Compose plugin.
  • A domain and TLS configuration if you plan to expose a web interface publicly.

Set up the app

Open the upstream setup instructions for the version you intend to deploy.

  1. Check out the Umami release you plan to run and open its Compose file.
  2. Set a unique application secret and configure the PostgreSQL credentials. Keep the values in your environment or secrets store.
  3. Validate the Compose configuration, then start the application and database.
Shell
docker compose config --quiet
docker compose up -d
docker compose ps

Configuration

DATABASE_URLPostgreSQL connection URL. Keep the password private.
APP_SECRETUnique random value for securing authentication tokens.

Security

Complete initial setup on a private connection. Use unique credentials and limit public access to the services you need to expose. Enable HTTPS for public web interfaces.

Troubleshooting

Open the dashboard and change the initial administrator password before making the service public. Add a site and confirm a test page view appears.

Backups and updates

Back up PostgreSQL and retain a secure copy of your deployment configuration. Read the release notes before upgrading.

Prefer hands-off deployment?

If you want to skip manual Linux administration, reverse proxy configuration, SSL renewals, firewall hardening, and automated backup scripting, our platform engineers can deploy and manage Umami on your server.

Deploy Umami

Managed deployment

  1. 1. Choose plan
  2. 2. Review order
Service plan
What’s included in Production Stack
  • Everything in Starter Deployment
  • Dedicated PostgreSQL / MySQL / ClickHouse configuration
  • Persistent database volume & storage tuning
  • Redis cache / background worker configuration
  • Automated database dump & offsite backup script (S3/R2 ready)
  • Log rotation & resource limit safeguards

References

Want our platform engineers to deploy Umami for you?

Complete turnkey setup, security hardening, automated daily backups, and ongoing maintenance on your own VPS.

Deploy Umami

Managed deployment

  1. 1. Choose plan
  2. 2. Review order
Service plan
What’s included in Production Stack
  • Everything in Starter Deployment
  • Dedicated PostgreSQL / MySQL / ClickHouse configuration
  • Persistent database volume & storage tuning
  • Redis cache / background worker configuration
  • Automated database dump & offsite backup script (S3/R2 ready)
  • Log rotation & resource limit safeguards