coder-k8s

Use native Kubernetes APIs to run and manage Coder.

[!WARNING] This is experimental alpha software from a hackathon. Do not use it in production. Do not make it available to end users.

What you get

coder-k8s is one binary with three components:

The operator is a Kubernetes controller. It creates and updates the Coder control planes, provisioners, and workspace proxies that these custom resources describe. The aggregated API server adds Coder workspaces, templates, and template versions to the Kubernetes API, so you can use kubectl with them. Template versions are read-only. The MCP (Model Context Protocol) server gives tools to AI agents and other MCP clients.

The --app flag selects the components that run. The default, --app=all, runs the operator and the aggregated API server in one process. The MCP server runs only with --app=mcp-http. For all values, see Architecture.

Quick start

Run these commands from a clone of this repository:

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-system

Then create a Coder instance:

kubectl create namespace coder
kubectl apply -f config/samples/coder_v1alpha1_codercontrolplane.yaml

For all the steps, see Deploy a Coder Control Plane.

Documentation

The documentation is at https://coder.github.io/coder-k8s/. The source is in docs/. To show a local preview, run make docs-serve.

• Getting started
• Deploy the aggregated API server
• Run the MCP server
• API reference

Examples

Contributing

See CONTRIBUTING.md. The license is Apache-2.0.