- Helm 3.5+ installed

- Workload Kubernetes cluster for Coder

1. Create a namespace for theCodercontrol plane. In this tutorial, we call it`coder`:

InstallingCoderon Rancher involves four key steps:

kubectl create namespace coder

1. Create a namespace for Coder

1. Set up PostgreSQL

1. Create a database connection secret

1. Install the Coder application via Rancher UI

1. Create aPostgreSQL instance:

Coder does not manage a database server for you. This is required for storing

data about your Coder deployment and resources.

kubectl create namespace coder

If you're in a public cloud such as

[Google Cloud](https://cloud.google.com/sql/docs/postgres/),

[AWS](https://aws.amazon.com/rds/postgresql/),

[Azure](https://docs.microsoft.com/en-us/azure/postgresql/), or

[DigitalOcean](https://www.digitalocean.com/products/managed-databases-postgresql),

you can use the managed PostgreSQL offerings they provide. Make sure that the

PostgreSQL service is running and accessible from your cluster. It should be in

the same network, same project, etc.

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:

You can install Postgres manually on your cluster using the

[Bitnami PostgreSQL Helm chart](https://github.com/bitnami/charts/tree/master/bitnami/postgresql#readme).

There are some[helpful guides](https://phoenixnap.com/kb/postgresql-kubernetes)

on the internet that explain sensible configurations for this chart.

Here's one example:

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

-[Google Cloud SQL](https://cloud.google.com/sql/docs/postgres/)

-[AWS RDS for PostgreSQL](https://aws.amazon.com/rds/postgresql/)

-[Azure Database for PostgreSQL](https://docs.microsoft.com/en-us/azure/postgresql/)

-[DigitalOcean Managed PostgreSQL](https://www.digitalocean.com/products/managed-databases-postgresql)

The cluster-internal DB URL for the above database is:

Ensure that your PostgreSQL service:

postgres://coder:coder@coder-db-postgresql.coder.svc.cluster.local:5432/coder?sslmode=disable

- Is in the same network/project as yourcluster

Optionally, you can use the

[Postgres operator](https://github.com/zalando/postgres-operator) to manage

PostgreSQL deployments on your Kubernetes cluster.

1. Create the PostgreSQL secret.

Create a secret with the PostgreSQL database URL string. In the case of the

self-managed PostgreSQL, the address will be:

After installation, the cluster-internal database URL will be:

kubectl create secret generic coder-db-url -n coder \

--from-literal=url="postgres://coder:coder@coder-db-postgresql.coder.svc.cluster.local:5432/coder?sslmode=disable"

For more advanced PostgreSQL management, consider using the

[Postgres operator](https://github.com/zalando/postgres-operator).

</div>

1. From the**Cluster Manager** console, go to**Apps** >**Charts**

kubectl create secret generic coder-db-url -n coder \

--from-literal=url="postgres://coder:coder@coder-db-postgresql.coder.svc.cluster.local:5432/coder?sslmode=disable"

1. Select**Partners** from the drop-down menu and search for`Coder`.

1. Select**Coder**, then**Install**.

1.Select thetarget namespace you created for Coder andselect**Customize Helm options before install**, then**Next**.

1.In theRancher Manager console,selectyour target Kubernetes cluster for Coder.

Select**Edit YAML** andenter configuration settingsforyour deployment.

1. From the dropdown menu, select**Partners** andsearchfor`Coder`

1. Select the`coder` namespace you created earlier and check**Customize Helm options before install**.

Select**Next**

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

<details>

<summary>Example values.yaml configuration</summary>

coder:

env:

-name:CODER_PG_CONNECTION_URL

valueFrom:

secretKeyRef:

name:coder-db-url

key:url

For available configuration options, refer to the[Helm chart documentation](https://github.com/coder/coder/blob/main/helm#readme)

or[values.yaml file](https://github.com/coder/coder/blob/main/helm/coder/values.yaml).

We support two release channels: mainline and stable - read the

[Releases](./releases.md) page to learn more about which best suits your team.

-**Mainline** Coder release:

</details>

1. Select a Coderversion:

helm install coder coder-v2/coder \

--namespace coder \

--values values.yaml \

--version 2.19.0

```

-**Mainline**:`2.20.x`

-**Stable**:`2.19.x`

-**Stable** Coder release:

Learn more about release channels in the[Releases documentation](./releases.md).

1. On the**Supply additional deployment options** screen:

</details>

1. Accept the default settings

1. Select**Install**

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

1. Navigate to**Apps** >**Installed Apps** in the Rancher UI.

1. Find and select Coder.

1. Use the options in the**⋮** menu for upgrade, rollback, or other operations.