Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.

Pulling a Docker image from a registry

Written by
Updated at October 9, 2026
View in Markdown

Warning

Starting October 13, 2026, Yandex Container Registry will be unavailable to new users.

The existing users can create resources until November 10, 2026. Afterwards, Yandex Container Registry will go read-only and cease to operate on December 14, 2026. For more information on how it will be handled, see this article on Yandex Container Registry sunset.

To pull a Docker image, you need the container-registry.images.puller role or higher. In addition, you need to know which repository houses the Docker image, as well as its tag or digest.

To work with Docker images, install and configure Docker.

  1. Select the Docker image you need. To do this, get a list of Docker images in the registry.

  2. Pull the Docker image from the registry:

    • Using the tag:

      docker pull cr.yandex/<registry_ID>/ubuntu:hello

      Result:

      hello: Pulling from crpd50616s9a********/ubuntu
84ed7d2f608f: Already exists
be2bf1c4a48d: Already exists
a5bdc6303093: Already exists
e9055237d68d: Already exists
Digest: sha256:035ac8e1bd9c49871a2fd76ccb3c4b0f84e7eee775919ccd345337ec********
Status: Downloaded newer image for cr.yandex/crpd50616s9a********/ubuntu:hello

    • Using the digest:

      docker pull cr.yandex/<registry_ID>/ubuntu@sha256:035ac8e1bd9c49871a2fd76

      Result:

      ccb3c4b0f84e7eee775919ccd345337ec7b49f80d
sha256:035ac8e1bd9c49871a2fd76ccb3c4b0f84e7eee775919ccd345337ec********: Pulling from crpd50616s9a********/ubuntu
84ed7d2f608f: Already exists
...
e9055237d68d: Already exists
Digest: sha256:035ac8e1bd9c49871a2fd76ccb3c4b0f84e7eee775919ccd345337ec********
Status: Downloaded newer image for cr.yandex/crpd50616s9a********/ubuntu@sha256:035ac8e1bd9c49871a2fd76ccb3c4b0f84e7eee775919ccd345337ec********

      Note that in this case, the Docker image will be pulled without a tag. The TAG field will show <none>.

  3. Make sure the Docker image has been pulled:

    docker image list

    Result:

    REPOSITORY                                  TAG     IMAGE ID      CREATED       SIZE
cr.yandex/crpd50616s9a********/ubuntu       <none>  50ff********  24 hours ago  86.7MB
ubuntu                                      latest  1d9c********  2 weeks ago   86.7MB

See also

Troubleshooting in Container Registry.

Previous
Pushing a Docker image to a registry
Next
Deleting a Docker image from a registry