Installation

This article walks you through the process of installing Coder onto your Kubernetes cluster.

Dependencies

Install the following dependencies:

• kubectl
• helm

For Production deployments: 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 onto your cluster (see the changelog for a list of Coder versions)

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

3. For Production deployments: Add the following to your helm chart so that Coder uses your external PostgreSQL databases:

   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 web servers running in your environment. To enable, provide a wildcard domain and its DNS certificate and update your helm chart accordingly.

5. After you've created the pod, tail the logs to find the randomly generated password for the admin user

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

   When this step is done, you will see:

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

   These are the credentials you need to continue setup using Coder's web UI.

If you lose your admin credentials, you can use the admin password reset process to regain access.

Accessing Coder

1. To access Coder's web UI, you'll need to get its IP address by running the following in the terminal to list the Kubernetes services running:

   kubectl --namespace coder get services
   

   The row for the ingress-nginx service includes an EXTERNAL-IP value; this is the IP address you need.

2. In your browser, navigate to the external IP of ingress-nginx.

3. Use the admin credentials you obtained in this installation guide's previous step to log in to the Coder platform. If this is the first time you've logged in, Coder will prompt you to change your password.

At this point, you're ready to proceed to configuring Coder.