Helm Installation (Beta)

Deploy DeepSource Enterprise Server on Kubernetes using helm.


Before proceeding, ensure you have the following prerequisites in place:

  1. Create two K8s node groups (for application & analysis workloads) and label the nodes in the node groups (eg: workload: deepsource-application & workload: deepsource-analysis)
  2. Create two namespaces
    1. deepsource - kubectl create ns deepsource
    2. atlas-jobs - kubectl create ns atlas-jobs
  3. Create an external database using the following guide: https://docs.deepsource.com/docs/enterprise-server-configuration#bring-your-own-database
  4. Obtain the registry username and password by reaching out to [email protected]
  5. Make sure to use at least helm v3.8.0, prior versions require HELM_EXPERIMENTAL_OCI=1environment variable to be set.


Login to the registry using the obtained credentials

helm registry login registry.replicated.com --username <username> —password <password>

Pull the helm chart

helm pull oci://registry.replicated.com/deepsource-fowl/experimental/deepsource

Extract the helm chart and edit the values.yaml

tar -xvzf deepsource-*.tar.gz
cd deepsource
vim values.yaml

Install DeepSource Enterprise Server

helm install deepsource —n deepsource .


To upgrade DeepSource Enterprise Server you can use thehelm upgrade command

helm upgrade deepsource -f <path-to-values.yaml> -n deepsource oci://registry.replicated.com/deepsource-fowl/experimental/deepsource


  1. For using Bitbucket with DeepSource edit the asgard.licenseFields.customerName in values.yaml OR set the value using --set asgard.licenseFields.customerName=<customer-name>
  2. To generate random passwords and keys for fields with the value xxxxx, you can use Python (python3 -c "import secrets; print(secrets.token_hex(20))") or shell ( date | md5)

Contact [email protected] if you face any issues during the installing or upgrading process.