Windows Setup via WSL2

Recommended for Windows users: run CPanel Rocky inside WSL2 Ubuntu, while Docker runs through Docker Desktop with WSL integration.

1. Enable WSL2

# PowerShell (Run as Administrator)
wsl --install
wsl --set-default-version 2

Reboot Windows, then install Ubuntu from Microsoft Store (or use wsl --install -d Ubuntu).

2. Prepare Ubuntu in WSL

sudo apt update
sudo apt install -y curl git build-essential ca-certificates

3. Install Node.js 20 + Go

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs golang-go

4. Install Docker Desktop + WSL integration

• Install Docker Desktop on Windows.
• Open Docker Desktop -> Settings -> Resources -> WSL Integration.
• Enable integration for your Ubuntu distro.

# inside WSL Ubuntu
docker --version
docker run --rm hello-world

5. Run panel + connector in WSL

cd ~/cpanel/panel
npm install
npm run upgrade-db
npm run dev

cd ~/cpanel/connector-go
go mod tidy
go build -o connector-go ./
CONNECTOR_CONFIG=./config.json VOLUMES_PATH=/var/lib/cpanel/volumes ./connector-go

6. Networking notes (important)

• Open panel from Windows browser using http://localhost:3000 (or your configured port).
• If you expose ports publicly, configure Windows firewall and router/NAT rules too.
• For easier public access, use the Cloudflare Tunnel guide in docs.