Requirements - Uncloud

Uncloud runs on bare metal servers or virtual machines. Here’s what you need.

Minimum Hardware

Single-Node (Development/Testing)

Resource	Minimum
CPU	4 cores
RAM	8 GB
Disk	100 GB SSD
Network	1 Gbps
OS	Ubuntu 22.04 LTS

Production (3-Node Cluster)

Resource	Per Node
CPU	8+ cores
RAM	32+ GB
Disk	500 GB NVMe SSD
Network	10 Gbps
OS	Ubuntu 22.04 LTS / Debian 12

For KubeVirt (VM support), nodes must have hardware virtualization enabled (Intel VT-x or AMD-V). Verify with egrep -c '(vmx|svm)' /proc/cpuinfo.

Software Requirements

Required

Software	Version	Purpose
Go	1.21+	Backend compilation
Node.js	18+	Frontend build
kubectl	1.28+	Kubernetes CLI

Installed by Provisioner

These are installed automatically by the Uncloud admin setup:

Component	Purpose
K3s	Lightweight Kubernetes
KubeVirt	Virtual machine management
Rook/Ceph or Longhorn	Storage provisioner
Cilium	CNI / networking
CoreDNS	DNS resolution
Metrics Server	Resource metrics
Prometheus	Monitoring
CloudNativePG	PostgreSQL operator

Network Requirements

Port	Protocol	Purpose
80	TCP	HTTP (redirects to HTTPS)
443	TCP	HTTPS
6443	TCP	Kubernetes API
8080	TCP	Uncloud API
5173	TCP	Frontend dev server
30000-32767	TCP	Kubernetes NodePorts

Supported Operating Systems

OS	Version	Status
Ubuntu	22.04 LTS	Recommended
Ubuntu	20.04 LTS	Supported
Debian	12	Supported
Debian	11	Supported
Rocky Linux	9	Supported

Optional: External DNS

For custom domains and automatic TLS:

A domain name pointing to your server(s)
Wildcard DNS record for app subdomains (e.g., *.apps.example.com)
Port 80/443 open to the internet