Uncloud

A reference for managing Uncloud clusters with the `uc` CLI. This is a decentralized self-hosting platform that runs Docker services across peer machines connected by WireGuard mesh, with Caddy handling ingress on every node. The skill covers bootstrapping machines, deploying from Compose files with custom extensions like `x-ports` and `x-caddy`, publishing HTTP/HTTPS through Caddy or raw TCP/UDP to hosts, and routing to external LAN devices via static proxy entries. Also includes volume management, DNS resolution inside the mesh, and image distribution across the cluster. Genuinely useful if you're running Uncloud, otherwise niche. The command surface is clean and the Compose extensions are well thought out for a distributed setup without central control planes.

skills.sh installs: 1.2K
GitHub stars: 229.1K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add affaan-m/everything-claude-code --skill uncloud --agent claude-code

Installs into .claude/skills of the current project.

Files

Uncloud Cluster Management

Reference for the uc CLI — a decentralised self-hosting platform using Docker containers, WireGuard mesh networking, and Caddy reverse proxy.

When to Activate

Use this skill when working with Uncloud clusters, especially when:

Bootstrapping or joining machines with uc machine
Deploying services from Compose files with uc deploy
Publishing HTTP, HTTPS, TCP, or UDP ports through Uncloud
Configuring Caddy ingress with x-caddy, x-ports, or --caddyfile
Routing external LAN devices through the cluster proxy
Inspecting logs, service state, volumes, DNS, or machine placement

How It Works

Uncloud runs Docker services across peer machines connected by a WireGuard mesh. Each machine is an equal cluster member; services communicate on the overlay network and Caddy runs globally to terminate public HTTP/HTTPS traffic. Compose files can use Uncloud extensions for ingress, placement, and generated Caddy configuration, while the uc CLI handles image distribution, scheduling, scaling, logs, and cluster state.