ClusterCanvas/README.md

ClusterCanvas

A web-based dashboard for managing Proxmox VMs and LXC containers. After configuration it discovers hosts and shows per‑instance details like hostname, storage and RAM usage, and status. From the same interface you can view logs, run updates, deploy changes, and perform other routine maintenance tasks.

Layout

Path	Role
service/	Go HTTP API
webui/	Vite + React + TypeScript SPA

Prerequisites

• Go 1.22+
• Node.js 20+ and npm

Run

Start the API (default :8080, override with PORT):

make service

Start the web UI (Vite on :5173, proxies /health and /api to the service):

make webui

Optional: set VITE_API_BASE_URL (defaults to http://localhost:8080) if you call the API without the Vite proxy.

Test

make test

This runs go test ./... in service/ and Vitest in webui/.

Build

make build

Produces bin/clustercanvas-server and webui/dist/.