Introduction

Intershop provides the base images of all current products as Docker images. Authorized users can download these Docker images 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 for the project-specific Docker registry

Process

Log in to the Docker Registry via an OIDC Provider

Intershop provides all Docker images in a Docker registry.

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 Customer Support.

   

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

Verify Your Permissions for Docker Images

Once you log in to the Docker Registry web interface, you can verify the images you are permitted to pull:

1. Navigate to the Projects section.

2. Review the projects listed:

   • If you see the icm project, you have access to all ICM images.

   • If you see the iom project, you have access to all IOM images.

The projects in your view represent the image repositories you are authorized to pull from.

If you cannot see the expected projects or are denied access when pulling images, contact Intershop Customer Support to verify your permissions.

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

Docker Pull

After 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

Image Naming Pattern

The images available in the Intershop Docker Registry follow a specific naming pattern that differs from the public Docker Hub convention.

Image Source Versus Registry Location

You may find image references like intershophub/icm-as:14.0.2 in documentation or in the Intershop Knowledge Base. These references represent the original image sources on Docker Hub.

Direct access via Docker Hub (intershophub) is not available. Instead, pull images from the Intershop Docker Proxy Cache Registry:

• Original reference: intershophub/icm-as:14.0.2

• Proxy cache URL: docker.tools.intershop.com/icm/intershophub/icm-as:14.0.2

Proxy Cache

docker.tools.intershop.com is a proxy cache managed by Intershop that mirrors and caches the official Intershop Docker images.

Always use the full proxy cache path (docker.tools.intershop.com) when pulling Intershop images, regardless of the naming convention shown elsewhere in the documentation.