Coder has open-sourced a new remote development platform 🥳 Check it out at coder/coder on GitHub.

Rancher Kubernetes Engine

This deployment guide shows you how to set up a bare-metal Rancher Kubernetes Engine (RKE) cluster on which Coder can deploy.


See here for the full list of Rancher requirements. You must have at least one Linux host (node) with the following utilities installed:



Since Coder requires dynamic storage provisioning, you'll need to install a Rancher-supported storage provisioner. We recommend using Longhorn, since it is tightly integrated with Rancher.


To configure pod networking, you'll need to install a Container Network Interface (CNI) into the Rancher cluster. Here are Rancher's recommended CNI providers


  1. Once you've installed the necessary dependencies, create a cluster.yml file

to define the Rancher cluster configuration. Below is an example for a single-node cluster:

    - address:
      user: ubuntu
        - controlplane
        - etcd
        - worker
      ssh_key_path: /home/ubuntu/.ssh/id_rsa
      ssh_agent_auth: true

Ensure the user is a member of the docker group.

For a multi-node, high availability cluster, see the Rancher documentation for additional configuration values.

  1. Deploy the cluster with the following command:
rke up --config cluster.yml
  1. After the cluster is brought up, create your kubeconfig file and copy over the

Rancher-generated configuration:

mkdir -p $HOME/.kube/ && cp kube_config_cluster.yml $HOME/.kube/config

Once complete, you can now install Coder on to your Rancher cluster.

Was this page helpful? Share your experience with us.


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