Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Configuring Docker authentication

Updated on October 21, 2022

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 the Constellation UI Service with Docker for the first time.

Before you begin: Obtain an API key from the Pega Digital Delivery site. For more information, see Using Pega-provided Docker images.
Note: 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.
    Important: You must paste the encoded ID and key in a single line in the config.json file.
  5. Save the file.

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us