Skip to content
Coder Docs
Install

Deploy Coder on Rancher

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

On this page

You can deploy Coder on Rancher as a Workload.

Requirements

Overview

Installing Coder on Rancher involves four key steps:

  1. Create a namespace for Coder
  2. Set up PostgreSQL
  3. Create a database connection secret
  4. Install the Coder application via Rancher UI

Create a namespace

Create a namespace for the Coder control plane. In this tutorial, we call it coder:

kubectl create namespace coder

Set up PostgreSQL

Coder requires a PostgreSQL database to store deployment data. We recommend that you use a managed PostgreSQL service, but you can use an in-cluster PostgreSQL service for non-production deployments:

For production deployments, we recommend using a managed PostgreSQL service:

Ensure that your PostgreSQL service:

  • Is running and accessible from your cluster
  • Is in the same network/project as your cluster
  • Has proper credentials and a database created for Coder

Create the database connection secret

Create a Kubernetes secret with your PostgreSQL connection URL:

kubectl create secret generic coder-db-url -n coder \
  --from-literal=url="postgres://coder:[email protected]:5432/coder?sslmode=disable"

Important

If you're using a managed PostgreSQL service, replace the connection URL with your specific database credentials.

Install Coder through the Rancher UI

Coder installed on Rancher

  1. In the Rancher Manager console, select your target Kubernetes cluster for Coder.

  2. Navigate to Apps > Charts

  3. From the dropdown menu, select Partners and search for Coder

  4. Select Coder, then Install

  5. Select the coder namespace you created earlier and check Customize Helm options before install.

    Select Next

  6. On the configuration screen, select Edit YAML and enter your Coder configuration settings:

  7. Select a Coder version:

    • Mainline: 2.36.1
    • Stable: 2.35.4

    Learn more about release channels in the Releases documentation.

  8. Select Next when your configuration is complete.

  9. On the Supply additional deployment options screen:

    1. Accept the default settings
    2. Select Install

  10. A Helm install output shell will be displayed and indicates the installation status.

Manage your Rancher Coder deployment

To update or manage your Coder deployment later:

  1. Navigate to Apps > Installed Apps in the Rancher UI.
  2. Find and select Coder.
  3. Use the options in the ⋮ menu for upgrade, rollback, or other operations.

Next steps

Edit on GitHub