Skip to main content

Quick Start

Purpose: For new users, shows how to install the CLI, create a Kind cluster, deploy platform services, and verify a running cluster (10 minutes configuration + 30–50 minutes deployment).

Prerequisites​

  • Docker installed and running
  • 8GB RAM available
  • 20GB disk space

Step 1: Install the CLI​

Pick one of the methods below. For the full list of options see the CLI Installation page.

Download a GitHub Release binary​

# Example: Linux amd64 — swap the suffix for your platform
curl -Lo opencenter https://github.com/rackerlabs/openCenter-cli/releases/download/v1.0.0/opencenter-linux-amd64
chmod +x opencenter
sudo mv opencenter /usr/local/bin/

Or install with go install​

go install github.com/opencenter-cloud/opencenter-cli@v1.0.0

Verify installation​

opencenter version

Expected output:

opencenter version 1.0.0

Step 2: Initialize a Kind Cluster​

# Create cluster configuration
opencenter cluster init my-first-cluster --type kind

# Review the generated configuration
opencenter cluster edit my-first-cluster

Step 3: Provision the Cluster​

# Generate and apply infrastructure
opencenter cluster setup my-first-cluster

# Check cluster status
opencenter cluster status my-first-cluster

Deployment takes roughly 30–50 minutes while Kind provisions nodes and FluxCD reconciles platform services.

Step 4: Bootstrap GitOps​

# Install FluxCD and start reconciliation
opencenter cluster bootstrap my-first-cluster

Step 5: Verify the Cluster​

# Check platform services
kubectl get pods -A

# Access the Headlamp UI
kubectl port-forward -n headlamp svc/headlamp 8080:80
# Open http://localhost:8080

Check Your Work​

  • All pods in flux-system namespace are Running
  • Platform services are deploying (cert-manager, kyverno, etc.)
  • Headlamp UI is accessible

Next Steps​