Pushing a Docker image to a registry

Written by

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.

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?