Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nebius.com/llms.txt

Use this file to discover all available pages before exploring further.

Container Registry helps to manage Docker images for your resources. This guide covers how to set up your environment to work with the service, create your first registry, upload and run a Docker image in it.

​
Prepare your environment

In this guide, you will use the terminal in your environment, e.g. on your local machine, to run commands that create and manage Nebius AI Cloud resources. The commands use the Nebius AI Cloud CLI and tools that you need to install first.
  1. Install Docker Engine:
  2. Install jq which parses JSON outputs from the Nebius AI Cloud CLI and extracts resource IDs for other commands: 
    sudo apt-get 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 NB_REGION_ID=<region_ID>

​
Create a registry

Create a test registry and save a part of its ID to an environment variable: 
export NB_REGISTRY_PATH=$(nebius registry create \
  --name quickstart-registry \
  --format json | jq -r ".metadata.id" | cut -d- -f 2)

​
Configure Docker

Configure Docker to work with the created registry:
  1. Run the Nebius AI Cloud Docker credential helper. It lets you use Nebius AI Cloud registries 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 /Users/user/.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.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
    Do not run the command as root.
  2. Assign the image a tag: 
    docker tag hello-world \
  cr.$NB_REGION_ID.nebius.cloud/$NB_REGISTRY_PATH/hello-world:hello
  3. Push the image to the Container Registry: 
    docker push cr.$NB_REGION_ID.nebius.cloud/$NB_REGISTRY_PATH/hello-world:hello
    Do not run the command as root.
  4. Run the image: 
    docker run cr.$NB_REGION_ID.nebius.cloud/$NB_REGISTRY_PATH/hello-world:hello