Creating a virtual registry

Written by

Yandex Cloud

Updated at August 10, 2026

View in Markdown

Note

You can create a virtual registry in any format except Debian and Go.

Management console

CLI

API

In the management console, select the folder where you want to create a virtual registry.
Navigate to Cloud Registry.
In the left-hand panel, select Registries.
In the top-right corner, click Create registry.
Select the registry format.
In the Registry type field, select Virtual.
Under Registries, use the Add registry button 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.

In the Registry access field, select:
- Read only to grant read-only access to the added registries.
- Read and upload to grant both read and upload access to the registries. You can only use one registry for uploads. Specify it in the Deployment registry field.
Specify the filtering patterns.
Enter a name and description for the registry.
Add labels in key: value format.
Click Create.

To create a virtual registry, run this command:

yc cloud-registry registry create \
  --name <registry_name> \
  --description <registry_description> \
  --registry-kind <registry_format> \
  --registry-type virtual \
  --properties <registry_properties>

Where:

--name: Registry name.
--description: Registry description.
--registry-kind: Registry format. Available formats: maven, npm, docker, nuget, pypi, and binary.
--registry-type: Registry type.
--properties: Registry properties. Provide them as a string in name1=value1,name2=value2 format. Available properties for virtual registries are as follows:
- registryIds: List of local and remote registry IDs in the order of their traversal. Provide in registryIds=registry1;registry2 format.
- readOnly: Permission to push artifacts to the registry. Possible values: true to deny or false to allow pushing.
- deploymentRegistryId: ID of the registry to push artifacts to. It is required if readOnly is false.

Result:

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

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

In the type field, specify VIRTUAL.

Creating a virtual registry

Was the article helpful?