Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

Pushing a Docker image to a registry

Written by
Updated at February 7, 2025

These instructions describe 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.

  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. (Optional) Assign a URL to the Docker image using the following format: cr.yandex/<registry_ID>/<Docker_image_name>:<tag>:

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

    Note

    You can only push Docker images to Container Registry if they have a URL in this format: cr.yandex/<registry_ID>/<Docker_image_name>:<tag>.

  3. Push the required 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.

Previous
Creating a Docker image
Next
Pulling a Docker image from a registry