Getting started with Container Registry

Using these instructions, you will create your first registry and try managing Docker images.

Before you start

To create a registry, you will need a folder in Yandex.Cloud. If you don't have any folders yet, create a new folder before creating a registry:

  1. Click Create folder in the Home page of the management console.

  2. Enter the folder name.

    The name must be unique within the folder. The name may contain lowercase Latin letters, numbers, and hyphens. The first character must be a letter. The last character can't be a hyphen. The maximum length of the name is 63 characters.

  3. Select Create a default network. A network is created with subnets in each availability zone.

  4. Click Create folder.

You will also need the Yandex CLI and Docker.

Creating a registry and performing basic operations on Docker images

  1. Create a registry in Container Registry:

    $ yc container registry create --name my-first-registry
    id: crpc9qeoft236r8tfalm
    folder_id: b1g0itj57rbjk9thrinv
    name: my-first-registry
    status: ACTIVE
    created_at: "2018-12-25T12:24:56.286Z"

    You will need the received ID to access the created registry.

  2. Authenticate to Container Registry using a Docker Credential helper:

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

      $ yc container registry configure-docker
      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 /home/<user>/.docker/config.json file must contain the following line:

      "": "yc"
  3. Pull a Docker image from the Docker Hub repository:

    $ docker pull ubuntu
  4. Assign a tag to the Docker image:

    $ docker tag <Docker image ID> \
  5. Push the Docker image to the repository:

    $ docker push \
  6. Run the Docker image:

    $ docker run \

See also