The software described in this documentation is either no longer supported or is in extended support.
Oracle recommends that you upgrade to a current supported release.

5.1 Using the Oracle Container Registry

The Oracle Container Registry contains Docker images for licensed commercial Oracle software products that you may use in your enterprise. To access the Oracle Registry Server, you must have an Oracle Single Sign-On account. The Oracle Container Registry provides a web interface that allows an administrator to authenticate and then to select the Docker images for the software that your organization wishes to use. Oracle Standard Terms and Restrictions terms must be agreed to via the web interface. Once Oracle Standard Terms and Restrictions have been agreed, it is possible to pull images of the software from the Oracle Container Registry using the standard Docker pull command.

To pull an image from the Oracle Container Registry

  1. In a web browser, navigate to https://container-registry.oracle.com and login via the Oracle Single Sign-On authentication service.

  2. Use the web interface to accept the Oracle Standard Terms and Restrictions for the Oracle software images that you intend to deploy. Your acceptance of these terms are stored in a database that links the software images to your Oracle Single Sign-On login credentials. Your acceptance of the Oracle Standard Terms and Restrictions is valid only for 8 hours from the time you last accepted it. This is subject to change without notice. If you have not pulled the image within the valid period for acceptance, you need to repeat the process before you attempt to pull the image.

  3. Use the web interface to browse or search for Oracle software images.

  4. On the host system, use the docker login command to authenticate against the Oracle Container Registry using the same credentials that you used to log into the web interface:

    # docker login container-registry.oracle.com

    The command prompts you for your username and password.

  5. On the host system, run:

    # docker pull container-registry.oracle.com/area/image[[:tag]] 

    Substitute area with the repository location in the registry and image with the name of the software image as hosted on the Oracle Container Registry. You may optionally specify a particular [[:tag] ] for the image. For example:

    # docker pull container-registry.oracle.com/os/oraclelinux:7
    # docker pull container-registry.oracle.com/java/serverjre

    Note that the area and image are nearly always specified in lower case. The command to pull an image is usually provided on the Repo Info page, when you are viewing the images in the web interface of the Oracle Container Registry. Other useful information about the image and how it should be run may also be available on the same page.

  6. If your credentials can be verified and the Oracle Standard Terms and Restrictions have been accepted, the image is pulled from the server and stored locally, ready to be used to deploy containers.