HomeInstallInstall the control plane

Install the control plane

On this page

The pages in this section are alternatives, not sequential steps. Choose the one that matches the platform your team already operates, or intends to operate, then follow it through to the end.

Choose a platform

Platform	Best suited to
Kubernetes	Production deployments, including high availability with multiple replicas
Rancher	Kubernetes clusters your team already manages through Rancher
OpenShift	Red Hat OpenShift clusters, which need specific security context settings
Docker	A single machine, such as a proof of concept or a small team deployment
RPM (RHEL family)	A single Red Hat Enterprise Linux host, or another RHEL-family distribution
Cloud providers	A virtual machine on AWS, Google Cloud, or Azure, or a marketplace listing
Community install methods	Platforms Coder doesn't package, where a community-contributed method exists

If your platform choice is still open, size the deployment first in Plan your deployment. The Coder Validated Architecture reference designs assume Kubernetes, which is the recommended platform for deployments that others depend on.

Before you move on

At the end of this phase you should be able to reach the Coder access URL, sign in as the first administrator, and see the deployment reported as healthy. If you prepared a license and an identity provider application in Prepare prerequisites, apply them now so that the deployment you validate is the one you intend to run.

Next: Validate your deployment.

Docker

Install and run Coder using the official Docker images for a quick single-machine deployment.

Kubernetes

Install Coder on a Kubernetes cluster using the official Helm chart for production deployments.

Rancher

Deploy Coder on Rancher as a Kubernetes workload using the Rancher UI and Helm.

OpenShift

Install Coder on a Red Hat OpenShift cluster using Helm, with the required security context settings.

RHEL-family Linux

Install the Coder control plane from an RPM package on Red Hat Enterprise Linux and other RHEL-family distributions.

Cloud platforms

Install guides and example templates for deploying Coder on AWS, Google Cloud, and Azure.

Community install methods

Community-contributed methods for installing Coder on platforms Coder doesn't package itself.