Cluster Wizard + WebUI (k3s)

This Quick Start guide provides a ways to launch CORESPEQ Cluster Wizard with the Wizard Client WebUI using K3s Deployment — lightweight Kubernetes-based setup

It delivers a functional Cluster Wizard environment suitable for evaluation, development, or small-scale production use. For larger or full production deployments, refer to the full Cluster Wizard Deployment documentation.

For full setup and configuration details visit:

• Cluster Wizard Deployment
• Wizard Client WebUI Deployment

---

warning

If the K3s machine's IP address changes after deployment, you will need to redeploy Cluster Wizard.

☸️ Deploying Cluster Wizard on K3s

note

The K3s deployment option assumes that a working K3s cluster is already installed and running. This guide does not cover installing K3s itself.

The K3s deployment of CORESPEQ Cluster Wizard with the Wizard Client WebUI provides a production-aligned environment using Kubernetes and Helm, automating:

• Installation of cert-manager and Helm
• Deployment of Cluster Wizard and Wizard Client WebUI
• Certificate generation and secret management
• NodePort-based service exposure

For complete installation instructions, and simple steps to install k3s, refer to the official GitHub project: Cluster Wizard K3s Deployment Repository

Highlights

• Single-script automated setup:

  curl -sfL https://raw.githubusercontent.com/corespeq-cw/deployments/refs/heads/main/k3s/setup-cluster-wizard-on-k3s.sh | bash -s -- <license-file>

• Integrates Helm, cert-manager, and Cluster Wizard services automatically.
• Accessible via:
  • Cluster Wizard API: https://<node-ip>:30002
  • Wizard Client WebUI: http://<node-ip>:30012

Access and Credentials

K3s deployment methods creates an admin certificate and private key for secure access to Cluster Wizard. You can use these credentials with either the Wizard Client CLI or Wizard Client WebUI.

Refer to:

• Wizard Client WebUI Deployment
• Wizard Client CLI Installation

Next Steps

Once Cluster Wizard and Wizard Client WebUI are deployed:

1. Log in to the WebUI using your admin certificate and private key.
2. Add new nodes using Node Wizard — see Node Wizard Installation Guide
3. Start managing VMs, storage, and users directly from the Cluster Wizard dashboard.

Learn More

• Wizard Client WebUI
  • Wizard Client WebUI Deployment
  • 🎬 Wizard Client WebUI Walkthrough (version 0.4.0-beta)
• Cluster Wizard
  • Cluster Wizard Deployment
  • 🎬 Cluster Wizard Deployment Walkthrough (version 0.4.0-beta)
• 💡 Cluster Wizard Overview

⚠️ Problems and Troubleshooting

• Login error:
  If you see
  "Error with login process. Please retry later or verify your credentials!"
  Some browsers (notably Firefox) trust the Wizard Client WebUI’s frontend certificate after you accept it, but not the backend certificate automatically.
  As a result, the WebUI may fail to function correctly.
  See Wizard Client WebUI Deployment Troubleshooting for solutions.

• Other issues:
  Check out Cluster Wizard Deployment Troubleshooting or Wizard Client WebUI Deployment Troubleshooting.