Deploy Uptime Kuma with Docker

Run the application from its upstream container image.

Deploy Uptime Kuma

Managed deployment

  1. 1. Choose plan
  2. 2. Review order
Service plan
What’s included in Starter Deployment
  • Turnkey single-container Docker setup
  • Reverse proxy with automatic Let's Encrypt SSL
  • UFW Firewall & SSH security hardening
  • Daily automated volume & config backup script
  • Application healthcheck & smoke testing
  • Handover guide & administrator credentials
Verified Recipe
Application version2.x
Recipe verificationVerified with upstream standard
Database in this deployment profileSQLite
CPU, RAM, and storageCheck 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.

  1. Install Docker on a host with persistent local storage. Reserve port 3001 on the loopback interface.
  2. Start the container with a named volume for application data.
  3. On the host, open http://127.0.0.1:3001 and create your administrator account.
Shell
docker run -d --name uptime-kuma \
  --restart unless-stopped \
  -p 127.0.0.1:3001:3001 \
  -v uptime-kuma:/app/data \
  louislam/uptime-kuma:2

Configuration

Use the upstream configuration reference for variables and defaults for your release.

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

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.

Deploy Uptime Kuma

Managed deployment

  1. 1. Choose plan
  2. 2. Review order
Service plan
What’s included in Starter Deployment
  • Turnkey single-container Docker setup
  • Reverse proxy with automatic Let's Encrypt SSL
  • UFW Firewall & SSH security hardening
  • Daily automated volume & config backup script
  • Application healthcheck & smoke testing
  • Handover guide & administrator credentials

References

Want our platform engineers to deploy Uptime Kuma for you?

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

Deploy Uptime Kuma

Managed deployment

  1. 1. Choose plan
  2. 2. Review order
Service plan
What’s included in Starter Deployment
  • Turnkey single-container Docker setup
  • Reverse proxy with automatic Let's Encrypt SSL
  • UFW Firewall & SSH security hardening
  • Daily automated volume & config backup script
  • Application healthcheck & smoke testing
  • Handover guide & administrator credentials