2 min read

Learn how to install Coder onto your infrastructure.

This article walks you through the process of installing Coder.


Install the following dependencies:

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
  2. Install the helm chart into the cluster

    kubectl create namespace coder
    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:

      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.

Our docs are open source. See something wrong or unclear? Make an edit.