Deploy Uptime Kuma with Docker Compose
Manage the application and its services in one Compose project.
| Application version | See upstream release requirements |
|---|---|
| Recipe verification | Verified with upstream standard |
| Database in this deployment profile | SQLite |
| 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.
- Download the upstream Compose file for the release you intend to run.
- Review the image tag and volume configuration. Use local storage with file locking and bind port 3001 to loopback for local setup.
- Validate the Compose file and launch the service.
docker compose config --quiet
docker compose up -d
docker compose psConfiguration
Use the upstream configuration reference for variables and defaults for your release.
Security
Troubleshooting
If the service does not start, check the application logs, verify database connectivity and storage permissions, and check for port conflicts.
Backups and updates
Stop the service before backing up its data volume. Preserve the volume when recreating the service.
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 Uptime Kuma on your server.