A modern self-service cloud portal for VMware vSphere, built as a replacement for vRealize / Aria Automation (vRA).
- Native vSphere: VM provisioning, inventory and day-2 operations run directly against vCenter (Go + govmomi). No vRO, no extra appliance.
- AWX for automation: AWX job templates and workflow job templates are first-class catalog items and day-2 actions, and run as steps after provisioning.
- Full service catalog: custom forms, dynamic values, approvals, leases, quotas, placement, naming, versioning and entitlements.
- EfficientIP SOLIDserver for IPAM and DNS.
- Modern UX: command palette, live request timelines, inline day-2 actions, dark mode, keyboard-first.
Status: slices 1 to 3 built, approvals included. The catalog, the request form, provisioning a VM and following it live, and deployments work end to end on the Docker Compose stack: real Temporal, Keycloak sign-in, vcsim (the vCenter simulator), and fake AWX and EfficientIP. CI runs on every push. See the roadmap.
| Part | How | Details |
|---|---|---|
| Whole stack | docker compose -f deploy/docker-compose.yml up --build, then http://localhost:3000 |
deploy/README.md |
| Backend only | make vcsim, rvav migrate -seed, rvav dev |
deploy/README.md, internal/README.md |
| Frontend on mock data | cd web && pnpm install && pnpm dev |
web/README.md |
| Frontend on the local API | cd web && pnpm dev:real (API on :8080 with RVAV_AUTH_MODE=dev and RVAV_ALLOW_DEV_AUTH=1) |
web/README.md |
| All checks | make check: spec lint, generated code, Go vet and tests, end-to-end tests, web app checks (what CI runs on every push); make check-quick, its fast part; make web-e2e, the browser tests, which CI runs daily |
Makefile |
| Doc | Content |
|---|---|
| User guide | Requesting, following, owning VMs; approving |
| Administrator guide | Integrations, infrastructure, projects, policies, the catalog, automation |
| Operations | Installing, configuring, running, watching, upgrading, backing up; runbooks; security; load test |
| Architecture | Components, tech stack, runtime flows |
| Domain model | Core entities and relationships |
| Service catalog | Full catalog feature specification |
| Integrations | vSphere, AWX, EfficientIP, identity, notifications |
| UX | UX principles and key screens |
| Frontend | React/TS/Vite, TanStack Router + Query, Tailwind + shadcn/ui architecture |
| API | OpenAPI contract (api/openapi.yaml) and API conventions; each rvav serves it at /api/v1/openapi.json, each release has its reference |
| Implementation plan | Path to 80% of vRA: parity table, slices, effort, calendar, risks |
| Roadmap | Status, releases and decisions |
| ADRs | Architecture decision records |