Is Uncloud in the official Debian repositories?

No — Uncloud is not packaged in the official Debian archives. This free mirror serves the newest Uncloud release that is at least 2 months old; the main repository at deb.griffo.io serves every release within hours of upstream.

How do I install the latest Uncloud on Debian?

Add the deb-free.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 Debian releases are supported?

Debian 12 Bookworm, Debian 13 Trixie, Forky and Sid.

Install Uncloud on Debian via apt

Source	Version
deb.griffo.io (main)	0.20.0 ✅
Official Debian	🚫 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 Staying Current Matters: 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.

            🆓 Free forever, patched immediately: Debian and Ubuntu freeze package versions when a release ships; this free mirror instead serves the newest release once it is at least 2 months old, with security fixes published immediately. Want every release within hours instead? That's the main repository at deb.griffo.io.
        

📦 Installation from deb-free.griffo.io

Step 1: Add Repository

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

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

sudo apt install extrepo
sudo extrepo enable griffo-free
sudo apt update
                

extrepo is Debian's own tool for external repositories: it writes the sources file and installs the signing key for you, after checking that key against signed metadata. This mirror is registered with it as griffo-free. Debian only (bookworm, trixie, forky, sid): extrepo publishes metadata for Debian suites only, so on Ubuntu use one of the other two tabs.

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-free.griffo.io?

📊 Installation Comparison:

Official Debian: Not available in official repositories
Install Script: Manual updates and dependency management
Manual Binary: No package management or automatic updates
deb.griffo.io (main): Latest version with automatic updates

✅ Latest Features: Get newest orchestration and networking improvements
✅ No Manual Setup: Pre-built binaries with all dependencies
✅ Automatic Updates: Packages updated once a release is at least 2 months old; security fixes ship immediately
✅ Complete Package: Includes all required components and scripts
✅ Multi-Distribution: Works on Bookworm, Trixie, and Sid
✅ Easy Maintenance: Standard apt commands for updates

📦 Package Build Repository

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

🌬️ uncloud-debian - Latest release builds

🔗 Related Packages

Also available from deb.griffo.io:

unregistry - Direct Docker image transfer (same author)
lazydocker - Terminal UI for Docker management
fzf Fuzzy Finder - Enhanced command searching

            🎯 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

☁️ Install Latest uncloud on Debian