This guide covers installing Uncloud from source on a fresh server.

Step 1: Clone the Repository

Step 2: Install the Backend

Step 3: Configure

Create or edit config.yaml in the project root:
Set environment variables:

Step 4: Start the API Server

Or run directly with Go:
The API server starts on http://localhost:8080. The SQLite database is created automatically.

Step 5: Install the Frontend

For production, serve the dist/ directory with any static file server (nginx, caddy, etc.).

Step 6: Run Infrastructure Setup

Open the dashboard and navigate to Admin → Setup, or use the API:
This installs:
  1. K3s (if not already installed)
  2. KubeVirt
  3. Storage provisioner
  4. Metrics Server
  5. CoreDNS
  6. Container Registry
  7. CloudNativePG
  8. Prometheus
  9. Object Storage
You can run individual steps if you only need specific components:

Step 7: Verify Installation

Running as a Service

Create /etc/systemd/system/dukaancloud.service:

Next Steps