Introduction

Intershop provides the base images of all current products as Docker images. These Docker images can be downloaded by authorized users and used for development and testing.

This guide explains how to connect to the Intershop Docker Registry to download an Intershop Docker image.

References

• Guide - Intershop Commerce Platform Development

• Guide - Access to Docker Images

Process

Log in to the Docker Registry via an OIDC Provider

Intershop provides all Docker images in a Docker registry.aber

1. Docker registry URL: https://docker.tools.intershop.com

2. Use the Login via OIDC Provider button. This redirects you to the OIDC Provider for authentication. The current OIDC Provider is Microsoft.
   You need an authorized Microsoft account to log in successfully. After the OIDC provider has authenticated you, you are redirected back to the Docker registry. If you are having trouble logging in, please contact Intershop Support.

   

3. After successful login, you will see the Docker Registry start page.

   

Docker CLI Login

The Docker CLI cannot handle redirection for OIDC, so our Docker registry provides a CLI secret to use when logging in from Docker.

1. Navigate to the User Profile settings.

   

2. Copy the username and the CLI secret or generate a new one:

   

3. Insert your username as the username and your CLI secret as the password to execute a Docker login:

docker login docker.tools.intershop.com -u XXX@user-intershop.de -p SuperStrongCLISecret

Note: Upper and lower case in the name are to be observed!

Docker Pull

After the successful login, an image can be pulled.

Run one of the following example commands to pull an image:

docker pull docker.tools.intershop.com/icm/intershophub/icm-as:X.X.X
docker pull docker.tools.intershop.com/iom/intershophub/iom:X.X.X