Deploy Uptime Kuma with Docker
Run the application from its upstream container image.
| Application version | 2.x |
|---|---|
| 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 on a supported host.
- 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.
- Install Docker on a host with persistent local storage. Reserve port 3001 on the loopback interface.
- Start the container with a named volume for application data.
- On the host, open http://127.0.0.1:3001 and create your administrator account.
docker run -d --name uptime-kuma \
--restart unless-stopped \
-p 127.0.0.1:3001:3001 \
-v uptime-kuma:/app/data \
louislam/uptime-kuma:2Configuration
Use the upstream configuration reference for variables and defaults for your release.
Security
Troubleshooting
Run docker logs uptime-kuma if the setup page fails to load. After setup, create an HTTP monitor and check that it records a result.
Backups and updates
Stop the container before taking a filesystem backup of its data volume. Read the project’s migration notes before changing major versions.
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.