Rancher

You can deploy Coder on Rancher as a Workload.

Requirements

• SUSE Rancher Manager running Kubernetes (K8s) 1.19+ with SUSE Rancher Prime distribution (Rancher Manager 2.10+)
• Helm 3.5+ installed
• Workload Kubernetes cluster for Coder

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:

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"

Install Coder through the Rancher UI

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:

   Example values.yaml configuration

   coder:
     # Environment variables for Coder
     env:
       - name: CODER_PG_CONNECTION_URL
         valueFrom:
           secretKeyRef:
             name: coder-db-url
             key: url
   
       # For production, uncomment and set your access URL
       # - name: CODER_ACCESS_URL
       #   value: "https://coder.example.com"
   
     # For TLS configuration (uncomment if needed)
     #tls:
     #  secretNames:
     #    - my-tls-secret-name
   

   For available configuration options, refer to the Helm chart documentation or values.yaml file.

7. Select a Coder version:

   • Mainline: 2.20.x
   • Stable: 2.19.x

   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