Yandex Cloud
Search
Discuss with expertTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex Cloud Registry
  • Getting started
    • All guides
        • Overview
        • Local
        • Remote
        • Virtual
    • Creating a lifecycle policy
  • Access management
  • Pricing policy
  • Terraform reference
  • Audit Trails events
  1. Step-by-step guides
  2. Managing a registry
  3. Creating a registry
  4. Virtual

Creating a virtual registry

Written by
Yandex Cloud
Updated at June 29, 2026
Management console
CLI
API
  1. In the management console, select the folder where you want to create a virtual registry.

  2. Navigate to Cloud Registry.

  3. In the left-hand panel, select  Registries.

  4. In the top-right corner, click Create registry.

  5. Select the registry format.

  6. In the Registry type field, select Virtual.

  7. 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.
  8. Enter a name and description for the registry.

  9. Add labels in key: value format.

  10. 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.

Was the article helpful?

Previous
Remote
Next
Viewing roles assigned for a registry
© 2026 Direct Cursus Technology L.L.C.