Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex Container Registry
  • Getting started
    • All guides
    • Installing and configuring Docker
    • Authentication in Container Registry
      • Getting information about existing Docker images
      • Creating a Docker image
      • Pushing a Docker image to a registry
      • Pulling a Docker image from a registry
      • Deleting a Docker image from a registry
    • Scanning Docker images for vulnerabilities
    • Creating a trigger for a registry
  • Yandex Container Solution
  • Access management
  • Pricing policy
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Troubleshooting
  • FAQ
  1. Step-by-step guides
  2. Managing a Docker image
  3. Pushing a Docker image to a registry

Pushing a Docker image to a registry

Written by
Yandex Cloud
Updated at October 26, 2026
View in Markdown

This guide describes how to push a local Docker image to a registry.

Note

To push an image, you need to configure Docker and get authenticated in the registry.

To push a Docker image to the registry, you need the container-registry.images.pusherrole or higher.

CLI
  1. View the list of available Docker images:

    docker image list
    

    Result:

    REPOSITORY                                  TAG     IMAGE ID      CREATED       SIZE
    cr.yandex/crpd50616s9a********/ubuntu       hello   50ff********  23 hours ago  86.7MB
    ubuntu                                      latest  1d9c********  2 weeks ago   86.7MB
    
  2. Optionally, assign a URL to the Docker image in the following format: cr.yandex/<registry_ID>/<Docker_image_name>:<tag>:

    docker tag ubuntu \
    cr.yandex/<registry_ID>/ubuntu:hello
    

    Note

    To push Docker images to Container Registry, you need to assign them URLs in this format: cr.yandex/<registry_ID>/<Docker_image_name>:<tag>.

  3. Push the Docker image to the registry:

    docker push cr.yandex/<registry_ID>/ubuntu:hello
    
  4. Make sure the image has been pushed to the registry by getting a list of docker images in the registry.

Was the article helpful?

Previous
Creating a Docker image
Next
Pulling a Docker image from a registry
© 2026 Direct Cursus Technology L.L.C.