Deploy Umami with Docker Compose
Manage the application and its services in one Compose project.
Verified Recipe
| Application version | See upstream release requirements |
|---|---|
| Recipe verification | Verified with upstream standard |
| Database in this deployment profile | PostgreSQL |
| CPU, RAM, and storage | Check 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.
- Check out the Umami release you plan to run and open its Compose file.
- Set a unique application secret and configure the PostgreSQL credentials. Keep the values in your environment or secrets store.
- Validate the Compose configuration, then start the application and database.
docker compose config --quiet
docker compose up -d
docker compose psConfiguration
| DATABASE_URL | PostgreSQL connection URL. Keep the password private. |
|---|---|
| APP_SECRET | Unique 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.