Installing Coder Enterprise

This article has been archived. Please see Coder Docs for the updated version.

The following steps will walk you through the process of installing Coder Enterprise onto your Kubernetes cluster.

Dependencies

Before proceeding, please ensure that you've installed the following dependencies:

• kubectl
• helm

For production instances, you will want to set up and use an external PostgreSQL instance to store data, including environment information and session tokens.

Installing Coder

1. Add the Coder helm repo

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

2. Install the helm chart into the cluster

   helm install --namespace coder coder coder/coder --version <VERSION-NUMBER>

3. For Production deployments: Modify the helm chart so that your Coder Enterprise installation uses your external PostgreSQL databases by adding the following to your heml chart in the cluster:

   postgres:
     useDefault: false
     host: HOST_ADDRESS
     port: PORT_NUMBER
     user: YOUR_USER_NAME
     database: YOUR_DATABASE
     passwordSecret: postgres-master
     sslMode: require

   You can find/define these values in your PostgreSQL server configuration file.

4. Enable Dev URL Usage. Dev URLs allow users to access the ports of services they are developing within their environment, and to enable this feature, you must provide a wildcard domain and accompanying DNS certificate and update your helm chart accordingly.

5. After the pod is created, start tailing the logs to find the randomly generated password for the admin user

   kubectl logs -l coder.deployment=cemanager -c cemanager --tail=-1 | grep -A1 -B2 Password

   When the cemanager is finished setting up, you will see something like this:

   ----------------------
   User: admin
   Password: kv...k3
   ----------------------

   These are the credentials you will use to set up the platform using Coder's web UI.