Creating a registry

Written by

Yandex Cloud

Updated at July 23, 2025

Management console

CLI

API

In the management console, select the folder you want to create a registry in.
In the list of services, select Cloud Registry.
In the left-hand panel, select Registries.
In the top-right corner, click Create registry.
Select the registry format.
Configure the registry format:
1. In the Registry type field, select the preferred registry type:
  - Local: Local registry. This type is available for all registry formats.
  - Remote: Remote registry. This type is available for the Maven, Npm, and Docker formats.
  - Virtual: Virtual registry. This type is available for the Maven, Npm, and Docker formats.
2. If you select Maven for format and Local for type, select a version policy in the Version policy field:
  - Release: For stable versions.
  - Snapshot: For development with frequent updates.
  - Mixed: A combination of Release and Snapshot for flexibility.
3. If you select Remote for type, select the remote registry's address:
  - For Maven, the available repositories are Maven Central and Axiom.
    
    Note
    
    You get access to Axiom on request. To activate access to Axiom, create a request to support.
  - For Npm, you can only use the Npm repository.
  - For Docker, you can only use the Docker Hub repository. You have to specify authentication data for Docker Hub.
    - Grant access to the contents of the Yandex Lockbox secret to the Cloud Registry service agent by assigning it the lockbox.payloadViewer role for this secret.
      
      Currently, you can only grant this access using the Yandex Cloud CLI command by specifying the ID of the Yandex Lockbox secret containing the token or password and the ID of the cloud you are creating the registry in:
      yc lockbox secret add-access-binding \ --id <secret_ID> \ --role lockbox.payloadViewer \ --agent cloud-registry:data-plane \ --cloud-id <cloud_ID>
    - Select the authentication method in Docker Hub:
      - To authenticate with an access token, select the Bearer authentication option and, in the Secret ID in Lockbox field, select the Yandex Lockbox secret with this token in its value key.
      - For authentication with a username and password, select the Basic authentication option and, in the Secret ID in Lockbox field, select the Yandex Lockbox secret with this password in its value key.
4. If you selected the Virtual registry type, use the Add registry button in the Registries field to add local and/or remote registries to the virtual registry by specifying their IDs.
  
  You can look up the registry ID in the management console on the registry info page.
Enter a name and description for the registry.
Click Create.

To create a registry, run this command:

yc cloud-registry registry create \
  --name <registry_name> \
  --description <registry_description> \
  --registry-kind <registry_format> \
  --registry-type <registry_type>

Where:

--name: Registry name.
--description: Registry description.
--registry-kind: Registry format. The available values are maven, npm, and docker.
--registry-type: Registry type. The available values are local, remote, and virtual.

Result:

done (3s)
id: cn1fsnc2dak********
folder_id: b1gc1t4cb638********
name: my-first-registry
kind: DOCKER
type: LOCAL
status: ACTIVE
description: docker
created_at: "2024-11-30T16:11:12.901356Z"
modified_at: "2024-11-30T16:11:16.243323Z"

To create a registry, use the create REST API method for the Registry resource or the RegistryService/Create gRPC API call.

Creating a registry

Was the article helpful?