-[Rancher](https://ranchermanager.docs.rancher.com/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster)

- alternative link:[Deploy Rancher Manager](https://ranchermanager.docs.rancher.com/getting-started/quick-start-guides/deploy-rancher-manager)

- other requirements

The first thing to do

helm repo add coder-v2 https://helm.coder.com/v2

Create a`values.yaml` with the configuration settings you'd like for your

deployment. For example:

coder:

env:

-name:CODER_PG_CONNECTION_URL

valueFrom:

secretKeyRef:

name:coder-db-url

key:url

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:

helm install coder coder-v2/coder \

--namespace coder \

--values values.yaml \

--version 2.19.0

-**Stable** Coder release:

helm install coder coder-v2/coder \

--namespace coder \

--values values.yaml \

--version 2.18.5

You can watch Coder start up by running`kubectl get pods -n coder`. Once Coder

has started, the`coder-*` pods should enter the`Running` state.

Use`kubectl get svc -n coder` to get the IP address of the LoadBalancer. Visit

this in the browser to set up your first account.

If you do not have a domain, you should set`CODER_ACCESS_URL` to this URL in

the Helm chart and upgrade Coder (see below). This allows workspaces to connect

to the proper Coder URL.

To upgrade Coder in the future or change values, you can run the following

command:

helm repo update

helm upgrade coder coder-v2/coder \

--namespace coder \

-f values.yaml

Use the[Observability Helm chart](https://github.com/coder/observability) for a

pre-built set of dashboards to monitor your control plane over time. It includes

Grafana, Prometheus, Loki, and Alert Manager out-of-the-box, and can be deployed

on your existing Grafana instance.

We recommend that all administrators deploying on Kubernetes set the

observability bundle up with the control plane from the start. For installation

instructions, visit the

[observability repository](https://github.com/coder/observability?tab=readme-ov-file#installation).

-[SUSE Rancher Manager](https://ranchermanager.docs.rancher.com/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster) running Kubernetes (K8s) 1.19+ with[SUSE Rancher Prime distribution](https://documentation.suse.com/cloudnative/rancher-manager/latest/en/integrations/kubernetes-distributions.html) (Rancher Manager 2.10+)

- Helm 3.5+ installed

- Workload Kubernetes cluster for Coder

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

kubectl create namespace coder

1. Create a PostgreSQL instance:

<divclass="tabs">

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

data about your Coder deployment and resources.

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.

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:

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

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

You can optionally use the

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

PostgreSQL deployments on your Kubernetes cluster.

</div>

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:

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 the target workload K8s cluster for Coder in the Rancher Manager console and access the Kubectl shell.

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

1. From the Chart providers, search for Coder.

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

1. Select the target namespace you created for Coder and select**Customize Helm options before install**, then**Next**.

1. Configure Values used by Helm that help define the Coder App. Review step 4 from the standard Kubernetes installation for suggested values, then Next.

1. Accept the defaults on the last pane and select Install.

A Helm install output shell will be displayed and should indicate success when completed.

1. To update a Coder deployment, select Coder from the Installed Apps and update as desired.