Run and manage Coder with native Kubernetes APIs.
Warning
Experimental alpha software from a hackathon. Do not use it in production or expose it to end users.
One binary, three components:
| Component | Manages | API group |
|---|---|---|
| Operator | CoderControlPlane, CoderProvisioner, CoderWorkspaceProxy (CRDs) |
coder.com/v1alpha1 |
| Aggregated API server | CoderWorkspace, CoderTemplate (backed by a live Coder instance) |
aggregation.coder.com/v1alpha1 |
| MCP server | Tools for inspecting and operating the above over HTTP | — |
Pick what runs with --app:
--app |
Runs |
|---|---|
all (default) |
Operator and aggregated API server in one process |
controller |
Operator only |
aggregated-apiserver |
Aggregated API server only |
mcp-http |
MCP server only (never part of all; needs --mcp-token-file) |
From a clone of this repo:
kubectl create namespace coder-system
kubectl apply -f config/crd/bases/ -f config/rbac/
kubectl apply -f deploy/
kubectl rollout status deployment/coder-k8s -n coder-systemThen create a Coder instance:
kubectl create namespace coder
kubectl apply -f config/samples/coder_v1alpha1_codercontrolplane.yamlFull walkthrough: Deploy a Coder Control Plane.
📖 https://coder.github.io/coder-k8s/ (source in docs/; preview with make docs-serve)
| Example | Shows |
|---|---|
examples/cloudnativepg/ |
CoderControlPlane backed by CloudNativePG PostgreSQL |
examples/argocd/ |
The whole stack from one Argo CD ApplicationSet |
examples/coder-templates/ |
Reusable CoderTemplate manifests |
See CONTRIBUTING.md. Licensed under Apache-2.0.