Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Cloud Registry
  • Getting started
  • Access management
  • Pricing policy
  • CLI reference
  • Audit Trails events

In this article:

  • Getting started
  • Creating a registry and pushing a Docker image

Getting started with Cloud Registry

Written by
Yandex Cloud
Improved by
Danila N.
Updated at April 22, 2025
  • Getting started
  • Creating a registry and pushing a Docker image

Use this guide to create your first registry and try your hand at managing Docker images.

Getting startedGetting 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:

  1. In the management console, select the appropriate cloud from the list on the left.

  2. At the top right, click Create folder.

  3. Give your folder a name. The naming requirements are as follows:

    • It must be from 2 to 63 characters long.
    • It may contain lowercase Latin letters, numbers, and hyphens.
    • It must start with a letter and cannot end with a hyphen.
  4. Optionally, specify the description for your folder.

  5. Select Create a default network. This will create a network with subnets in each availability zone. Within this network, you will also have a default security group, inside which all network traffic will be allowed.

  6. Click Create.

Creating a registry and pushing a Docker imageCreating a registry and pushing a Docker image

To work with Cloud Registry and Docker images:

  1. Install the Yandex Cloud CLI and configure Docker.

  2. Create a registry in Cloud Registry.

  3. Get authenticated in Cloud Registry.

  4. Pull a Docker image from Docker Hub:

    docker pull ubuntu
    
  5. 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
    
  6. Push the Docker image to the repository Cloud Registry:

    docker push \
    registry.yandexcloud.net/<registry_ID>/ubuntu:hello
    
  7. Run the Docker image:

    docker run \
    registry.yandexcloud.net/<registry_ID>/ubuntu:hello
    

See alsoSee also

  • Java artifact
  • Node.js artifact

Was the article helpful?

Next
All guides
© 2025 Direct Cursus Technology L.L.C.