Skip to main content

Table of Contents

Configuring Docker authentication

Set up the first download of a Docker image from a Pega repository by configuring a Docker authentication config.json file. This configuration is required when installing Constellation with Docker for the first time.

Obtain an API key from the Pega Digital Delivery site. For more information, see Using Pega-provided Docker images.
If you cannot see the Request access key tile on the Digital Delivery site, contact Pega Support. For internal users, you can create a Service Management request to get the Docker image access privilege.

Pega requires re-authenticating to download Docker images from its repository. As a Linux user, you can set up an authentication file to store your credentials for the Pega Docker repository. In this way, you can use the file with Docker commands to conveniently authenticate your identity when you download a new image.

  1. In a Linux bash shell with root privileges, in the /home/<Linux_username>/ folder, create a .docker directory.

  2. In the /home/<Linux_username>/.docker/ folder, create a config.json file.

  3. In the terminal window, encode your user ID and API access key in base64 by entering echo -n'<ID>:<key>' | base64

    The variables have the following values:
    • <ID> is the user ID that you receive in an email from Pega Delivery.
    • <key> is the access key that you receive in an email from Pega Delivery.
  4. In the config.json file that you created in step 2, enter the following code:

    	"auths": {
    		"": {
    			"auth": "<encoded_ID_and_key>"
    <encoded_ID_and_key> is the string that you generated in step 3.
    You must paste the encoded ID and key in a single line in the config.json file.
  5. Save the file.

Did you find this content helpful?

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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