[Yandex Cloud documentation](../../../index.md) > [Yandex Cloud Registry](../../index.md) > [Step-by-step guides](../index.md) > Managing artifacts > Docker image > Pushing a Docker image to a registry

# Pushing a Docker image to a registry in Cloud Registry

These instructions describe how to push a local [Docker image](../../concepts/artifacts/docker.md) to a registry.

{% note info %}

To push an image, you need to [configure](installation.md) Docker and [get authenticated](authentication.md) in the registry.

{% endnote %}

To push a Docker image to the registry, you need the `cloud-registry.artifacts.pusher` [role](../../security/index.md#cloud-registry-artifacts-pusher) or higher.

{% list tabs group=instructions %}

- CLI {#cli}

  1. View the list of available [Docker images](../../concepts/artifacts/docker.md):

     ```bash
     docker image list
     ```

     Result:

     ```text
     REPOSITORY                                  TAG     IMAGE ID      CREATED       SIZE
     registry.yandexcloud.net/crpd50616s9a********/ubuntu       hello   50ff********  23 hours ago  86.7MB
     ubuntu                                      latest  1d9c********  2 weeks ago   86.7MB
     ```

  1. (Optional) Assign a URL to the Docker image using the following format: `registry.yandexcloud.net/<registry_ID>/<Docker_image_name>:<tag>`:

     ```bash
     docker tag ubuntu \
     registry.yandexcloud.net/<registry_ID>/ubuntu:hello
     ```

     {% note info %}

     To push Docker images to Cloud Registry, you need to assign them URLs in this format: `registry.yandexcloud.net/<registry_ID>/<Docker_image_name>:<tag>`.

     {% endnote %}

  1. Push the required Docker image to the registry:

     ```bash
     docker push registry.yandexcloud.net/<registry_ID>/ubuntu:hello
     ```

{% endlist %}