Cloud-native workspace platform for Kubernetes
Kube Workspaces provides browser-accessible development environments running as pods in your Kubernetes cluster. It manages the full lifecycle of workspaces including creation, proxying, authentication, and resource governance via Custom Resource Definitions.
| Repository | Description |
|---|---|
| controller | Kubernetes controller (kubebuilder) — manages Workspace, Image, User, AuthConfig CRDs |
| api | REST API service (Go, Goa v3) — workspace CRUD, auth, image management |
| proxy | Reverse proxy (Go) — routes browser traffic to workspace pods |
| frontend | Web UI (Next.js, TypeScript) — workspace management dashboard |
| deploy | Deployment manifests (Helm, Kustomize, ArgoCD) and documentation |
| image-catalog | Catalog of Image CRs — source of truth for available workspace images |
Browser → Ingress → Frontend (Next.js)
→ API (Goa) → Kubernetes API
→ Proxy → Workspace Pods
Controller ← watches CRDs
All images are published to GitHub Container Registry:
ghcr.io/kube-workspaces/controllerghcr.io/kube-workspaces/apighcr.io/kube-workspaces/proxyghcr.io/kube-workspaces/frontend
# Install CRDs
kubectl apply --server-side -k https://github.com/kube-workspaces/deploy/kustomize/crds
# Deploy all components
kubectl apply --server-side -k https://github.com/kube-workspaces/deploy/kustomize/base
# Or use Helm
helm install kube-workspaces https://github.com/kube-workspaces/deploy/helm/kube-workspaces \
--namespace kube-workspaces-system --create-namespace