coder-k8s¶
Run and manage Coder with native Kubernetes APIs.
Alpha software
This project is an experimental prototype. Do not use it in production.
What it does¶
coder-k8s is one binary with three components. Choose which ones run with --app:
--app |
Runs | Resources |
|---|---|---|
all (default) |
Operator and aggregated API server in one process (not the MCP server) | Everything below except MCP |
controller |
Operator | CoderControlPlane, CoderProvisioner, CoderWorkspaceProxy (coder.com/v1alpha1) |
aggregated-apiserver |
Aggregated API server | CoderWorkspace, CoderTemplate (aggregation.coder.com/v1alpha1) |
mcp-http |
MCP server | Operational tools over HTTP |
See Architecture for how the pieces fit.
Where to start¶
| I want to… | Read |
|---|---|
| Get a Coder instance running | Deploy a Coder Control Plane |
| Add external provisioners | Deploy an External Provisioner |
| Deploy with GitOps | Deploy with Argo CD |
| Run only the operator | Deploy the controller |
| Connect an external PostgreSQL database | Connect an external PostgreSQL database |
Manage workspaces and templates with kubectl |
Deploy the aggregated API server |
| Connect an AI agent or other MCP client | Run the MCP server |
| Fix a problem | Troubleshooting |
| Look up a field | API reference |