This section contains guides for creating a compatible cluster on common cloud platforms, including Microsoft Azure, Google Cloud Platform, and Amazon Web Services. If you already have a Kubernetes cluster that meets Coder's requirements, you can proceed to the installation guide.

Supported Kubernetes versions

You can deploy Coder to any compatible Kubernetes cluster. Coder follows the Kubernetes upstream version support policy, and the latest stable release version of Coder supports the previous two minor releases as well as the current release of Kubernetes at time of publication.

During installation, Helm will check to ensure that Coder is compatible with your cluster version; if not, the installation process will fail, and you will receive an error message indicating the minimum cluster version required.

Coder continuously removes usage of deprecated Kubernetes API versions once the minimum baseline version of Kubernetes supports the necessary features in a stable version. We follow this policy to ensure that Coder stops using deprecated features before they are removed from new versions of Kubernetes.

You can opt to use v1.19 or v1.20, you'll see warning messages during the installation process. Coder does not allow the use of v1.18 or earlier.

Kubernetes 1.24Kubernetes 1.23Kubernetes 1.22Kubernetes 1.21Kubernetes 1.20Kubernetes 1.19Kubernetes 1.18
Coder 1.32
Coder 1.31
Coder 1.30
Coder 1.29
Coder 1.28
Coder 1.27
Coder 1.26

Incompatible Kubernetes distributions

See an opportunity to improve our docs? Make an edit.