Qu\'est-ce que 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.
⚡ 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.
apt upgrade vous garde toujours à la dernière version.
📦 Installation depuis deb.griffo.io
Étape 1 : Ajouter le dépôt
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 updateinstall -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 updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Il existe un miroir gratuit pour toujours. deb-free.griffo.io distribue des paquets gratuitement pour toujours — sans compte, sans abonnement, au plus 2 mois derrière l'upstream, correctifs de sécurité immédiats. Il contient aujourd'hui cliamp, Ghostty, lazydocker, Oh My Posh et Zed ; Uncloud n'en fait pas partie, le dépôt ci-dessus reste donc le seul moyen de l'installer — demandez-le et il pourra y être ajouté.
🧩 À propos de l'option extrepo. extrepo est l'outil de Debian pour les dépôts externes : il écrit le fichier de sources et installe la clé de signature à votre place, après l'avoir vérifiée face à des métadonnées signées. Ce dépôt y est enregistré sous le nom griffo, et le miroir gratuit à vie sous griffo-free ; sur Debian (bookworm, trixie, forky et sid), les commandes ci-dessus constituent donc toute l'installation.
extrepo ne met en place que le fichier de sources et la clé : les identifiants d'un abonnement vont toujours dans /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu n'est pas couvert, car extrepo ne publie de métadonnées que pour les suites Debian : utilisez-y les commandes avec sudo ou en root.
Étape 2 : Installer uncloud
# Install latest uncloud
sudo apt installer uncloud
# Vérifier l'installeration
uc --version# Install latest uncloud
apt installer uncloud
# Vérifier l'installeration
uc --version🎯 Exemples d'utilisation de base
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 lsDeploy 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 lsManage 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🚀 Pourquoi choisir deb.griffo.io ?
- 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: 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 within hours of upstream releases
- ✅ Complete Package: Includes all required components and scripts
- ✅ Multi-Distribution: Works on Bookworm, Trixie, and Sid
- ✅ Easy Maintenance: Standard apt commands for updates
📦 Dépôt de construction de paquets
Les paquets Debian sont automatiquement construits et maintenus dans ce dépôt GitHub :
- 🌬️ uncloud-debian - Latest release builds
🔗 Paquets associés
Également disponible depuis deb.griffo.io :
- unregistry - Direct Docker image transfer (same author)
- lazydocker - Terminal UI for Docker management
- fzf Fuzzy Finder - Enhanced command searching