Cluster Wizard + WebUI (Docker Compose)
This Quick Start guide provides a ways to launch CORESPEQ Cluster Wizard with the Wizard Client WebUI using Docker Compose Deployment — containerized local environment
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:
If the EXTERNAL_IP address changes after deployment, you will need to redeploy Cluster Wizard.
🐳 Deploying Cluster Wizard with Docker Compose
The Docker Compose deployment option assumes that Docker and Docker Compose are already installed and available. This guide does not install Docker or Docker Compose.
The Docker Compose project provides a self-contained environment suitable for testing, and demos.
It includes:
- PostgreSQL Database
- Cluster Wizard Service
- Wizard Client WebUI
- Automatic Certificate and CA generation
For full setup and configuration details, visit: Cluster Wizard Docker Compose Repository
💻 Windows and macOS Compatibility
The Docker Compose deployment for CORESPEQ Cluster Wizard runs on Windows 10/11, macOS, and Linux, providing a consistent setup experience across all platforms.
Highlights
- Easy local setup:
docker compose up -d - Compatible with Linux, macOS, and Windows.
- Compatible with both Docker and Podman
- Supports optional non-sudo setup
- Access via:
- Wizard Client WebUI:
https://<EXTERNAL_IP>:25080
- Wizard Client WebUI:
Access and Credentials
Docker compose deployment methods creates an admin certificate and private key for secure access to Cluster Wizard. It also creates a user admin with password password. You can use these credentials with either the Wizard Client CLI or Wizard Client WebUI.
Refer to:
Next Steps
Once Cluster Wizard and Wizard Client WebUI are deployed:
- Log in to the WebUI using your admin certificate and private key.
- Add new nodes using Node Wizard — see Node Wizard Installation Guide
- Start managing VMs, storage, and users directly from the Cluster Wizard dashboard.
Learn More
- Wizard Client WebUI
- Cluster Wizard
- 💡 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.