Skip to main content

Self-hosting made simple

Deploy and manage web applications across multiple machines without the complexity of Kubernetes. Connect any machines into a secure network and run containerized apps using familiar Docker Compose files.

Get StartedLearn the Concepts

Quick Start

Get your first application running on Uncloud in minutes

1

Install Uncloud CLI

Install the Uncloud CLI on your local machine:
brew install psviderski/tap/uncloud

# or using curl (macOS/Linux)
curl -fsS https://get.uncloud.run/install.sh | sh
2

Initialize your first machine

Connect to a remote machine and initialize your cluster:
uc machine init root@your-server-ip
This command installs Docker (if needed), sets up the Uncloud daemon, and configures a secure WireGuard mesh network.
3

Deploy your first service

Deploy a container with automatic HTTPS:
uc run -p app.example.com:8000/https image/my-app
Create a DNS A record pointing app.example.com to your server’s IP. Your app is now live at https://app.example.com

Why Uncloud?

Powerful infrastructure primitives without the operational complexity

No Control Plane

Fully decentralized design eliminates single points of failure. Each machine maintains a synchronized copy of cluster state.

Automatic Networking

Zero-config WireGuard mesh with NAT traversal. Containers get unique IPs for direct cross-machine communication.

Docker Compose

Use familiar Docker Compose format for defining services. No need to learn a new DSL or configuration language.

Zero-Downtime Deployments

Rolling updates without service interruption. Health checks ensure new containers are ready before old ones stop.

Built-in HTTPS

Caddy reverse proxy handles TLS certificate provisioning and renewal automatically using Let’s Encrypt.

Multi-Region Support

Deploy anywhere — cloud VMs, bare metal, or Raspberry Pis. Combine different providers into a unified cluster.

Explore the Documentation

Everything you need to get started with Uncloud

Installation

Install the Uncloud CLI on macOS, Linux, or Windows

Architecture

Learn how Uncloud’s decentralized design works

Machine Management

Add, remove, and configure machines in your cluster

Deploying Services

Deploy containerized applications from images or Compose files

Networking

Understand WireGuard mesh and service discovery

CLI Reference

Complete reference for all CLI commands

Ready to get started?

Follow our quickstart guide to deploy your first application on Uncloud in just a few minutes.

Read the QuickstartView on GitHub

Join the Community

Get help, share ideas, and connect with other Uncloud users

Discord Community

Join discussions, ask questions, and get real-time support

GitHub Discussions

Share feedback, request features, and contribute to development