Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Cloud Registry
  • Getting started
    • All guides
    • Creating a registry
        • Installing and configuring Docker
        • Authentication in Cloud Registry
        • Creating a Docker image
        • Pushing a Docker image to a registry
        • Pulling a Docker image from a registry
  • Access management
  • Pricing policy
  • CLI reference
  • Audit Trails events
  1. Step-by-step guides
  2. Managing artifacts
  3. Docker image
  4. Pulling a Docker image from a registry

Pulling a Docker image from a registry Cloud Registry

Written by
Yandex Cloud
Updated at December 16, 2024

To download a Docker image, you need the cloud-registry.artifacts.puller role or higher.

To work with Docker images, install and configure Docker.

CLI
  1. Select the Docker image you need.

  2. Pull the Docker image from the registry:

    • Using the tag:

      docker pull registry.yandexcloud.net/<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 registry.yandexcloud.net/crpd50616s9a********/ubuntu:hello
      
    • Using the digest:

      docker pull registry.yandexcloud.net/<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 registry.yandexcloud.net/crpd50616s9a********/ubuntu@sha256:035ac8e1bd9c49871a2fd76ccb3c4b0f84e7eee775919ccd345337ec********
      

      Note that in this case the Docker image will be pulled with no tag. In the TAG field, there will be <none>.

  3. Make sure the Docker image has been pulled:

    docker image list
    

    Result:

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

Was the article helpful?

Previous
Pushing a Docker image to a registry
Next
Getting information about existing Helm charts
Yandex project
© 2025 Yandex.Cloud LLC