Getting started with Container Registry: Create your first registry and manage a Docker image in it

​

Prepare your environment

1. Install Docker Engine:
   • Ubuntu
   • macOS
2. Install jq which parses JSON outputs from the Nebius AI Cloud CLI and extracts resource IDs for other commands:
   Ubuntu

   macOS

   sudo apt-get install jq
   

   brew install jq
   
3. Install the Nebius AI Cloud CLI (how to install) which manages all Nebius AI Cloud resources:
   curl -sSL https://storage.eu-north1.nebius.cloud/cli/install.sh | bash
   
4. Configure the Nebius AI Cloud CLI:
   nebius profile create
   
   The last command, nebius profile create, will guide you through several prompts. After you complete the prompts, your browser will open the Nebius AI Cloud web console sign-in screen. Sign in to the web console to complete the initialization. If you have access to multiple tenants, the CLI will prompt you to choose a tenant ID. After that, save your project ID in the CLI configuration: If the project ID has not been configured during the nebius profile create flow, get the project ID and save it in the CLI configuration:
   nebius config set parent-id <project_ID>
   
5. Create an environment variable for the region in which your project is located:
   export REGION_ID=<region_ID>
   
   For available region IDs, see Nebius AI Cloud regions.

​

Create a registry

export REGISTRY_PATH=$(nebius registry create \
  --name quickstart-registry \
  --format json | jq -r ".metadata.id" | cut -d- -f 2)

​

Configure Docker

1. Run the Nebius AI Cloud Docker credential helper. It lets you use registries in Container Registry without running the docker login.
   nebius registry configure-helper
   
2. Check that the credential helper is configured:
   1. Open the file from the previous command output, for example, with the cat command:
      cat ~/.docker/config.json
      
   2. Check that the credHelpers property contains the following lines:
      "cr.eu-north1.nebius.cloud": "nebius"
      "cr.eu-north2.nebius.cloud": "nebius"
      "cr.eu-west1.nebius.cloud": "nebius"
      "cr.eu-west2.nebius.cloud": "nebius"
      "cr.me-west1.nebius.cloud": "nebius"
      "cr.uk-south1.nebius.cloud": "nebius"
      "cr.us-central1.nebius.cloud": "nebius"
      

​

Push and run a Docker image

1. Pull an image from the Docker Hub:
   docker pull hello-world
   
2. Assign the image a tag:
   docker tag hello-world \
     cr.$REGION_ID.nebius.cloud/$REGISTRY_PATH/hello-world:hello
   
3. Push the image to the Container Registry:
   docker push cr.$REGION_ID.nebius.cloud/$REGISTRY_PATH/hello-world:hello
   
4. Run the image:
   docker run cr.$REGION_ID.nebius.cloud/$REGISTRY_PATH/hello-world:hello