Skip to main content
Registries in Container Registry store and easily access Docker images. This guide will help you create and delete registries in Container Registry.

​
How to create a registry

To create a Container Registry registry, run the Nebius AI Cloud CLI command: 
nebius registry create \
  --name <registry_name>
Though the --name flag is not required, the registry name simplifies finding the registry in the Nebius AI Cloud registries list. To access the created registry, do the following:
  1. Get the region of the project in which you created a registry. You can get it from the endpoint saved in your configuration: 
    nebius config get endpoint
    In the output, copy the part after api.. See all region IDs in Nebius AI Cloud regions.
  2. In the metadata.id field from the output, copy the registry ID part without the registry- prefix.
  3. Use the values in the registry URL: 
    cr.<region_ID>.nebius.cloud/<registry_path>

​
How to delete a registry

To delete a registry:
  1. Get its ID and path by listing the registries: 
    nebius registry list
    The ID is returned in the .metadata.id field of the registry resource. The registry path is the registry ID part without the registry- prefix.
  2. Check that the registry does not contain images. If you’ve already set up the Region ID and registry path environment variables, use the following command: 
    docker images cr.$NB_REGION_ID.nebius.cloud/$NB_REGISTRY_PATH
    Alternatively, use the following command: 
    docker images cr.<region_ID>.nebius.cloud/<registry_ID_without_the_registry-_part>
    For example, for the registry with the registry-a00bcdefghe12xyz3f ID in the eu-north1 region, use the following command: 
    docker images {cr.eu-north1.nebius.cloud}/a00bcdefghe12xyz3f
    See all region IDs in Nebius AI Cloud regions.
  3. Run the following command with the registry ID: 
    storage.<region_ID>.nebius.cloud registry delete --id <registry_ID>
If you have just one registry and are sure it does not contain images, use this set of commands to delete it quicker: 
export NB_REGISTRY_ID=$(nebius registry list \
  --format json | jq -r ".items[0].metadata.id")
nebius registry delete --id $NB_REGISTRY_ID