Using your own DB

If you are planning to use an existing database, you will need to configure the environment variables, in the values.yaml file.

See this documentation link for a basic understanding of environment variables used in the Deploy helm chart.

Using an existing or external database

Note: Skip this section if you do not want to use your own database instance. The Deploy Helm chart will deploy a single instance of PostgreSQL by default.

However, if you plan on using your own database with Deploy, then you need to follow the steps given below.

Edit the following in the values.yaml file:

  • Change 'postgresql.install' to 'false'
  • UseExistingDB.Enabled: true
  • UseExistingDB.XL_DB_URL: jdbc:postgresql://<postgres-service-name>.<namespace>.svc.cluster.local:5432/<xld-database-name>
  • UseExistingDB.XL_DB_USERNAME: Database User for xl-deploy
  • UseExistingDB.XL_DB_PASSWORD: Database Password for xl-deploy

Note: To specify the values for the steps above, you must first create the following database in your existing postgresql instance, using the steps given below:

CREATE USER <xld-username> WITH
ENCRYPTED PASSWORD '<xld-password>';

CREATE DATABASE <xld-database-name>;

ALTER ROLE <xld-username> WITH PASSWORD '<xld-password>';
ALTER DATABASE <xld-database-name> OWNER to <xld-username>;

The postgres-service-name is obtained by executing command

oc get service

get service postgres info only

Enabled: true
# If you want to use an existing database, change the value to "true".
#Uncomment the following lines and provide the values.
XL_DB_USERNAME: <xld-username>
XL_DB_PASSWORD: <xld-password>


  • If you have database instances running outside the cluster. Configure the parameters given above to match your setup.
  • Add the appropriate scc(security context constraints) to the service accounts of the Postgres database.

If you plan to use an AWS RDS database see configuring AWS RDS, for more information.

Next Step