5.1 Pulling Oracle Linux Images from a Container Registry

You can get Oracle Linux images to run on the Docker Engine from the oraclelinux repository at the Docker Hub. For a list of the Oracle Linux images that are available, see https://hub.docker.com/_/oraclelinux/).

An Internet connection is required to pull images from the Docker Hub or the Oracle Container Registry. If you make use of a proxy server to access the Internet, see Section 2.5, “Configuring a Proxy Server”.

Oracle Linux images, along with many other Oracle product images, are also hosted on the Oracle Container Registry at https://container-registry.oracle.com and on the Docker Hub at https://hub.docker.com. More information on using the Oracle Container Registry to pull images is covered in Section 6.1, “Pulling Images from the Oracle Container Registry”. See Section 6.4, “Using the Docker Hub” for more information on using the Docker Hub.

To download an Oracle Linux image, use the docker pull command. For example, to pull an Oracle Linux image from the Docker Hub:

# docker pull oraclelinux:7-slim
Trying to pull repository docker.io/library/oraclelinux ... 
7-slim: Pulling from docker.io/library/oraclelinux
977461c90301: Pull complete 
Digest: sha256:0743f72832d8744a89b7be31b38b9fb2e5390044cbb153cd97b3e797723e4704
Status: Downloaded newer image for oraclelinux:7-slim

To display a list of the images that you have downloaded to a system, use the docker images command, for example:

# docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
oraclelinux         7-slim              c2b5cb5bcd9d        7 days ago          118MB
oraclelinux         7                   31f4bed1dc33        7 days ago          232MB
oraclelinux         latest              31f4bed1dc33        7 days ago          232MB
oraclelinux         8                   8988c7081e1f        5 weeks ago         411MB

Each image in the repository is distinguished by its TAG value and its unique IMAGE ID. In the example, the tags 7 and latest refer to the same image ID for Oracle Linux 7.

When new images are made available for Oracle Linux updates, the tags 7, 8, and latest are updated in the oraclelinux repository to refer to the appropriate newest version.

If an image is downloaded from an alternate registry to the default registry, the REPOSITORY value also indicates the registry from which the image was pulled. For example:

# docker images
REPOSITORY                                     TAG        IMAGE ID        CREATED       SIZE
container-registry.oracle.com/os/oraclelinux   latest     31f4bed1dc33    7 days ago    232MB

See Section 4.6, “Setting Container Registry Options” for more information on adding registries and configuring a default registry.