Getting started with Cloud Registry
Written by
Updated at March 17, 2026
Use this guide to create your first registry and try your hand at managing Docker images.
Getting started
To create a registry, you will need a folder in Yandex Cloud. If you do not have any folders yet, create one before creating a registry:
Creating a registry and pushing a Docker image
To work with Cloud Registry and Docker images:
-
Install the Yandex Cloud CLI and configure Docker.
-
Create a registry in Cloud Registry.
-
Get authenticated in Cloud Registry.
-
Pull a Docker image from Docker Hub
:docker pull ubuntu -
Assign the pulled Docker image a tag in this format:
registry.yandexcloud.net/<registry_ID>/<Docker_image_name>:<tag>:docker tag ubuntu \ registry.yandexcloud.net/<registry_ID>/ubuntu:hello -
Push the Docker image to the repository Cloud Registry:
docker push \ registry.yandexcloud.net/<registry_ID>/ubuntu:hello -
Run the Docker image:
docker run \ registry.yandexcloud.net/<registry_ID>/ubuntu:hello