๐Ÿ“ฃ Important update โ€” access is changing on 1 October 2026

Starting 1 October 2026 at noon (UK time), this mirror will require authentication to keep apt working.
Downloading packages stays free from the GitHub repositories where they are built.
A yearly subscription gets you free immediate updates through apt and directly supports keeping this project alive. Thank you! ๐Ÿ™

๐Ÿ”‘ Get Your Yearly Subscription

โ‚ฌ15 / $15 / ยฃ15 per year โ€” US dollars if your currency isn't supported.

๐Ÿ’ฌ Questions, issues or anything about this repo? Join our Discord community โ€” the best place to get help and connect with other users.
โ˜• Previously supported via Buy Me a Coffee? You are wonderful! Head over to our Discord and we will sort out a free lifetime subscription for you. ๐Ÿ’œ

โ˜๏ธ Install Latest uncloud on Ubuntu

Lightweight container orchestration bridging Docker and Kubernetes

Latest version: 0.20.0 ยท updated 2026-07-17
SourceVersion
deb.griffo.io0.20.0 โœ…
Official Ubuntu๐Ÿšซ not packaged
โ† Back to home

What is uncloud?

uncloud is a lightweight clustering and container orchestration tool created by Pasha Sviderski that lets you deploy and manage web apps across cloud VMs and bare metal with minimal cluster management overhead. It bridges the gap between Docker simplicity and Kubernetes power, providing Docker simplicity with multi-machine power.

๐ŸŽฏ The Sweet Spot: Modern cloud platforms like Heroku offer amazing developer experiences but at premium prices. Kubernetes provides power but requires significant expertise. uncloud finds the pragmatic middle ground - own your infrastructure, stay simple as you grow, build with proven primitives.
โš ๏ธ Development Status: uncloud is currently in active development and is not ready for production use. Features may change significantly between releases. Perfect for experimentation and learning!
๐Ÿš€ Why Latest Versions Matter: uncloud is rapidly evolving with frequent releases containing new orchestration features, performance improvements, and enhanced multi-machine capabilities. The latest versions include better WireGuard mesh networking, improved service discovery, and enhanced Docker Compose compatibility.

โšก Key Features of uncloud

๐ŸŒ Multi-Machine Deployment

Deploy across cloud VMs, dedicated servers, and bare metal. Combine different providers into unified computing environment.

๐Ÿณ Docker Compose Compatible

Use familiar Docker Compose format for defining services. No need to learn new configuration languages or complex YAML.

๐Ÿ”’ 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 decentralized design eliminates single points of failure. Each machine maintains synchronized cluster state through peer-to-peer communication.

๐Ÿ” Service Discovery

Built-in DNS server resolves service names to container IPs. Automatic load balancing and ingress with HTTPS via Caddy.

๐Ÿ“ฆ Persistent Storage

Run stateful services with Docker volumes managed across machines. Data persistence without complex storage orchestration.

๐Ÿš€ Always ahead of the official archives: Debian and Ubuntu freeze package versions when a release ships โ€” this repository publishes new upstream releases typically within hours. A simple apt upgrade keeps you on the latest version.

๐Ÿ“ฆ Installation from deb.griffo.io

Step 1: Add Repository

sudo install -d -m 0755 /etc/apt/keyrings curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null sudo apt update
install -d -m 0755 /etc/apt/keyrings curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null apt update

Step 2: Install uncloud

# Install latest uncloud sudo apt install uncloud # Verify installation uc --version
# Install latest uncloud apt install uncloud # Verify installation uc --version

๐ŸŽฏ Basic Usage Examples

Initialize your first cluster:

# Initialize cluster on first machine uc machine init root@your-server-ip # Add more machines to cluster uc machine add --name server2 root@second-server-ip # List cluster machines uc machine ls

Deploy applications:

# Deploy from Docker image with HTTPS uc run -p app.example.com:8000/https image/my-app # Deploy from Docker Compose file uc compose up -f compose.yaml # Scale service across machines uc scale my-app 3 # List running services uc ls

Manage deployments:

# Update service with new image uc update my-app image/my-app:v2 # View service logs uc logs my-app # Remove service uc rm my-app # Clean up cluster uc machine rm server2

๐Ÿš€ Why Choose deb.griffo.io?

๐Ÿ“Š Installation Comparison:
  • Official Ubuntu: Not available in official repositories
  • Install Script: Manual updates and dependency management
  • Manual Binary: No package management or automatic updates
  • deb.griffo.io: Latest version with automatic updates

๐Ÿ“ฆ Package Build Repository

The Ubuntu packages are automatically built and maintained in this GitHub repository:

๐Ÿ”— Related Packages

Also available from deb.griffo.io:

๐ŸŽฏ Perfect for: Developers who want multi-machine deployment without Kubernetes complexity, teams needing simple container orchestration, homelab enthusiasts, and anyone seeking the sweet spot between Docker and Kubernetes.

๐Ÿ’ Support This Project

If this repository saves you time and effort, please consider supporting it!

โญ Star on GitHub ๐Ÿฆ Share on Twitter

๐Ÿ“ฆ Recent releases from this repository

โ“ Frequently asked questions

Is Uncloud in the official Ubuntu repositories?

No โ€” Uncloud is not packaged in the official Ubuntu archives. This repository is currently the only apt source, serving Uncloud 0.20.0.

How do I install the latest Uncloud on Ubuntu?

Add the deb.griffo.io repository once using the instructions above, then run: sudo apt install uncloud. New releases arrive through the normal sudo apt upgrade.

Are the packages signed and how are they built?

Every package is signed with the repository's GPG key (EA0F721D231FDD3A0A17B9AC7808B4DD62C41256) and built from upstream releases in public GitHub packaging repositories that anyone can inspect.

Which Ubuntu releases are supported?

Ubuntu 22.04 Jammy, 24.04 Noble, 25.10 Questing and 26.04 Resolute.