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
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Container Registry
  • Getting started
  • Yandex Container Solution
  • Access management
  • Pricing policy
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Troubleshooting
  • FAQ

In this article:

  • Getting started
  • Creating a registry and performing basic operations on Docker images

Getting started with Container Registry

Written by
Yandex Cloud
Improved by
Danila N.
Updated at April 22, 2025
  • Getting started
  • Creating a registry and performing basic operations on Docker images

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.

To work with Container Registry and Docker images, install the Yandex Cloud CLI and configure Docker.

Creating a registry and performing basic operations on Docker imagesCreating a registry and performing basic operations on Docker images

  1. Create a registry in Container Registry:

    yc container registry create --name my-first-registry
    

    Result:

    ..done
    id: crpc9qeoft23********
    folder_id: b1g0itj57rbj********
    name: my-first-registry
    status: ACTIVE
    created_at: "2018-12-25T12:24:56.286Z"
    

    You will use the received ID to access the created registry later.

  2. Authenticate in Container Registry using Docker Credential helper:

    1. Configure Docker to use docker-credential-yc:

      yc container registry configure-docker
      

      Result:

      Credential helper is configured in '/home/<user>/.docker/config.json'
      

      During setup, information about the current user profile is saved.

    2. Make sure that Docker is configured.

      The following line must appear in the /home/<user>/.docker/config.json configuration file:

      "cr.yandex": "yc"
      
  3. Pull a Docker image from Docker Hub:

    docker pull ubuntu
    
  4. Assign the pulled Docker image a tag in this format: cr.yandex/<registry_ID>/<Docker_image_name>:<tag>:

    docker tag ubuntu \
    cr.yandex/<registry_ID>/ubuntu:hello
    
  5. Push the Docker image to the repository Container Registry:

    docker push \
    cr.yandex/<registry_ID>/ubuntu:hello
    
  6. Run the Docker image:

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

See alsoSee also

  • Creating a registry.
  • Authentication in Container Registry.
  • Creating a Docker image.
  • Pushing a Docker image.
  • Pulling a Docker image.
  • Running a Docker image on a VM.

Was the article helpful?

Next
All guides
Yandex project
© 2025 Yandex.Cloud LLC