Skip to main content
Version: Next 🚧

Concepts

Everything in WaaS revolves around four CRDs in the waas.xorhub.io/v1alpha1 API group:

  • A WorkspaceTemplate describes a desktop: image, sizing, protocols (VNC/RDP/SSH/KasmVNC), workload kind, uptime schedule, and which fields users may override.
  • A Workspace instantiates a template for one owner. It carries little more than the template reference, the owner, and the user's allowed overrides.
  • A WorkspaceImage is a catalog entry: an admin-approved image (or whole registry) with its supported protocols, architectures, and sizing bounds.
  • A WorkspacePolicy is the self-service envelope for a user or group: image subset, quotas, lifecycle (idle suspend, max lifetime), clipboard rules, override rights.

The pages in this section cover each mechanism in depth:

PageWhat it explains
Workspace lifecyclePhases, conditions, pause/resume, scheduled uptime/downtime
Templates and protocolsWorkload kinds, VNC/RDP/SSH/KasmVNC, credentials, user overrides
GovernanceCatalog + policies: who may create what, enforcement, audit
PlacementWhich namespace workloads land in, naming, quotas per namespace
VolumesHome volume retention, reuse and quotas
Workspace deletionWhat gets destroyed, what survives, how to unblock a stuck teardown