Deploy Uptime Kuma with Docker Compose

Manage the application and its services in one Compose project.

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 versionSee upstream release requirements
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 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. Download the upstream Compose file for the release you intend to run.
  2. Review the image tag and volume configuration. Use local storage with file locking and bind port 3001 to loopback for local setup.
  3. Validate the Compose file and launch the service.
Shell
docker compose config --quiet
docker compose up -d
docker compose ps

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

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.

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