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
+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 manaTop issues
#172Update Corrosion to the latest version from upstream23 comments · 2025-11-07#369uc down or uc undeploy would be nice20 comments · 2026-05-16#209Provide windows CLI with scoop14 comments · 2025-12-07#425Simplify SSH tunnel for better security11 comments · 2026-08-20#126Feature request: IPv6 support on Uncloud network10 comments · 2025-09-17#439feat: volume copying7 comments · 2026-10-07#348allow `!machine` in x-machines?7 comments · 2026-05-02#227[BUG] Support for Amazon Linux 2023 (GLIBC 2.34)7 comments · 2025-12-25
Discussions
#322Initialise a cluster from the machine itself0 comments · 2026-04-21#280Caddy L4 for TCP / UDP passthrough and SNI proxy4 comments · 2026-03-20#271sudo/root only needed for `uc machine init`?1 comments · 2026-03-16#268Multi tenant4 comments · 2026-03-12#289Add safeguards when multiple contexts are available11 comments · 2026-03-08#255Co-op Cloud & Uncloud1 comments · 2026-02-16#249Labels instead of extensions1 comments · 2026-01-30#241Is this an alternative to fly.io and dokploy ?1 comments · 2026-01-08
Latest release
v0.22.0 v0.22.0 2026-11-06This 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