Pushing a Docker image to a registry

Written by

Yandex Cloud

Updated at August 10, 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

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

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>.

Push the Docker image to the registry:

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

Make sure the image has been pushed to the registry by getting a list of docker images in the registry.

Pushing a Docker image to a registry

Was the article helpful?