psviderski /uncloud

A lightweight tool for deploying and managing containerised applications across a network of Docker hosts. Bridging the gap between Docker and Kubernetes ✨

★ 5,615⑂ 184👁 22⑃ 187● 236▤ 37
GoApache-2.0Created 2024-07-20uncloud.run
下载:v0.22.0v0.22.0 ↓0.22.02026-11-06
+1
日增长
5,615
stars
184
forks
22
watchers
187
prs
236
issues
37
releases

README

▸ Deploy and scale containerised apps across servers without Swarm or Kubernetes overhead ◂

  
    
    
    
    
  


Uncloud is a lightweight clustering and container orchestration tool that lets you deploy and manage web apps across
cloud VMs and bare metal with minimised cluster management overhead. It creates a secure WireGuard mesh network between
your Docker hosts and provides automatic service discovery, load balancing, ingress with HTTPS, and simple CLI commands
to manage your apps.

Unlike traditional orchestrators, there's no central control plane and quorum to maintain. Each machine maintains a
synchronised copy of the cluster state through peer-to-peer communication, keeping cluster operations functional even if
some machines go offline.

Uncloud is the solution for developers who want the flexibility of self-hosted infrastructure without the operational
complexity of Kubernetes.

 ✨ Features

 Deploy anywhere: Combine cloud VMs, dedicated servers, and bare metal into a unified computing environment,
  regardless of location or provider.
 Docker Compose: Familiar Docker Compose format for defining services and volumes. No
  need to learn a new bespoke DSL.
 Zero-downtime deployments: Rolling updates without service interruption. Automatic rollback on failure is coming
  soon.
 Unregistry integration: Build and push your Docker images directly to
  your machines without an external registry. It will transfer only the missing layers, making it fast and efficient.
 Service discovery: Built-in DNS server resolves service names to container IPs.
 Persistent storage: Run stateful services with Docker volumes managed across machines.
 Zero-config private network: Automatic WireGuard mesh with peer discovery and NAT traversal. Containers get unique
  IPs for direct cross-machine communication.
 No control plane: Fully decentralised design eliminates single points of failure and reduces operational overhead.
 Imperative over declarative: Favoring imperative operations over state reconciliation simplifies both the mental
  model and troubleshooting.
 Managed DNS: Automatic DNS records .xxxxxx.uncld.dev for services with public access via managed
  Uncloud DNS service.
 Automatic HTTPS: Built-in Caddy reverse proxy handles TLS certificate provisioning and renewal using Let's
  Encrypt.
 Cluster storage for TLS certificates: Cluster storage for Caddy
  shares certificates and ACME challenge tokens across machines and coordinates issuance.
 Docker-like CLI: Familiar commands for managing both infrastructure and applications.
 Remote management: Control your entire infrastructure through SSH access to any single machine in the cluster.

 🎬 Quick demo

The screenshot below demonstrates how we use Uncloud to deploy https://uncloud.run website to 2 remote machines from
the compose.yaml file on the local machine.

It exposes the container port 8000/tcp as HTTPS on uncloud.run domain, served by the Caddy reverse proxy on the
remote machines. All mana

Top issues

Discussions

Latest release

v0.22.0 v0.22.0 2026-11-06
This release makes cluster storage for Caddy the default, adds service and container labels, a new uc service update command to change a service without recreating its containers, uc image rm to clean up images across machines, and DNS names for machines. It also brings fixes for logs, faster stop-first deployments, and a much calmer daemon on busy clusters.

 ⚠️ Heads-up before upgrading

- uc caddy deploy now deploys the Uncloud Caddy image with cluster storage (22b1c68). Upgrading Uncloud doesn't touch your running Caddy. But the next uc caddy deploy switches it to the new image and sto

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON