Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

Unable to execute the Pega Docker Container



A Docker Deamon is executed on AWS. On spinning up a new Docker Container, which is the official running Image of DockerHub:, the user is unable to execute the Pega Docker Container.

During the startup, the following command is used:

docker run -p 8080:8080 -e DB_HOST=pega83dbfull_baseline -e DB_NAME=pega83 -e DB_USERNAME=pega83 -e DB_PASSWORD=pegasys -e JDBC_URL=jdbc:postgresql://localhost:5432/pega83 -e JDBC_CLASS=org.postgresql.Driver --link pega83dbfull_baseline --name pega83 pegasystems/pega:8.3

Error Messages

java.sql.SQLException: Cannot load JDBC driver class 'org.postgresql.Driver'

Steps to Reproduce

  1. Retrieve the image from the Docker Hub.
  2. Execute the Image with the related command. The build fails

Root Cause

A defect or configuration issue in the operating environment.
The command to execute the Docker pointed to the local host instead of the container's IP address. Since it was unable to point to the database, the server failed to start.


Perform the following local-change:
  1. Execute docker inspect db_container_name 
  2. Copy the IP address from networks {} and use it while connecting to the database.
  3. Provide a URL to download the driver file (
  4. Ensure to provide the Env variables for the Rules and the Data Schema.


    docker run -p 8088:8080 -e DB_NAME=pega -e DB_USERNAME=pega

    -e DB_PASSWORD=pegasys -e JDBC_URL=jdbc:postgresql://IP_OF_Container:5432/pega

    -e JDBC_CLASS=org.postgresql.Driver


    -e RULES_SCHEMA=pegarules -e DATA_SCHEMA=pegadata pegasystems/pega:8.3

Suggest Edit

Published December 2, 2021

Did you find this content helpful? Yes No

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us