Skip to main content

Web console and API

Route map, WebSocket endpoints and the Fabric HTTP API. The full route map lives in WEB_CONSOLE.md.

Back to the README · Docs index

Same backend, same auth, as the CLI — the console is a signed-in SPA served from the same NodePort as the API. This is the short version; the full route map lives in docs/WEB_CONSOLE.md.

RoutePurpose
/appDashboard
/app/createLinux (cloud-init) or Windows (Kryton) create
/app/vms/:namePower, expose, cloud-init, snapshots, hotplug, resize, Rescue mode (admin) — docs/RESCUE.md
/app/vms/:name/consoleSerial · VNC · SSH
/app/snapshots · /app/migrationsSnapshots · live migration
/app/storage · /app/volumesRook-Ceph · fleet PVCs · optional Atlas backend/RBD/object-store/DR/governance
/app/databridgeAtlas DataBridge: cloud-to-edge DB migration (optional) — docs/ATLAS_INTEGRATION.md
/app/access-controlUsers & roles (admin)
/app/podsEvery pod: Terminal.app-style live logs, shell, events, YAML, restart/delete (admin) — docs/PODS.md
/app/disk-imagesImage catalog as a black Terminal.app listing (zorvia template images on the CLI)
/app/quotas · /app/network-policiesReal ResourceQuota / NetworkPolicy
/app/templates · /app/windowsOS catalog · Kryton inventory
/app/placement · /app/capacity · /app/optimizerPlacement · headroom · right-sizing
/app/backups · /app/schedules · /app/alertsBackup · power cron · alerts
wss://<HOST>:30152/ws/console/<vm>?token=<jwt>
wss://<HOST>:30152/ws/vnc/<vm>?token=<jwt>
wss://<HOST>:30152/ws/ssh/<vm>?token=<jwt>&user=ubuntu
wss://<HOST>:30152/ws/pods/<ns>/<pod>/logs?token=<jwt> # cluster.admin
wss://<HOST>:30152/ws/pods/<ns>/<pod>/exec?token=<jwt> # cluster.admin

Set ZORVIA_EXPOSE_HOST for correct NodePort SSH/VNC/RDP hostnames in the UI.

Fabric API (same auth as the console):

MethodPathNotes
POST/api/v1/auth/loginJWT
GET/api/v1/health · /api/v1/featuresLiveness · maturity registry
GET/api/v1/adopt/reportRead-only adoption report (?all_namespaces=true); same as zorvia adopt
GET/POST/api/vmsList / create
POST/api/vms/:name/start|stop|restartPower
GET/POST/api/vms/:name/snapshotsSnapshots
GET/api/audit/exportJSONL audit trail (?format=jsonl)

Password from zorvia-auth — not committed defaults. Lab smoke: docs/LAB.md.