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

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

Container Registry helps you manage Docker images for your resources.

This guide covers how to set up your environment to work with the service, create your first *registry*, push a Docker image to it and run the image.

## Prepare your environment

In this guide, you will use the terminal in your environment, for example, 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:

   * [Ubuntu](https://docs.docker.com/engine/install/ubuntu/)
   * [macOS](https://docs.docker.com/desktop/install/mac-install/)

2. Install **jq** which parses JSON outputs from the Nebius AI Cloud CLI and extracts resource IDs for other commands:

   <CodeGroup>
     ```bash Ubuntu theme={null}
     sudo apt-get install jq
     ```

     ```bash macOS theme={null}
     brew install jq
     ```
   </CodeGroup>

3. Install the **Nebius AI Cloud CLI** ([how to install](/cli/install)) which manages all Nebius AI Cloud resources:

   ```bash theme={null}
   curl -sSL https://storage.eu-north1.nebius.cloud/cli/install.sh | bash
   ```

4. Configure the **Nebius AI Cloud CLI**:

   ```bash theme={null}
   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](/iam/manage-projects#how-to-get-a-project-id) and save it in the CLI configuration:

   ```bash theme={null}
   nebius config set parent-id <project_ID>
   ```

5. Create an environment variable for the [region](/overview/regions) in which your project is located:

   ```bash theme={null}
   export REGION_ID=<region_ID>
   ```

   For available region IDs, see [Nebius AI Cloud regions](/overview/regions).

## Create a registry

Create a test registry and save a part of its ID to an environment variable:

```bash theme={null}
export 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 registries in Container Registry without running the `docker login`.

   ```bash theme={null}
   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:

      ```bash theme={null}
      cat ~/.docker/config.json
      ```

   2. Check that the `credHelpers` property contains the following lines:

      ```json theme={null}
      "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

<Note>
  Do not run Docker commands as root. The credential helper is configured for your user account, so root may not be able to access the credentials.
</Note>

1. Pull an image from the [Docker Hub](https://hub.docker.com/):

   ```bash theme={null}
   docker pull hello-world
   ```

2. Assign the image a tag:

   ```bash theme={null}
   docker tag hello-world \
     cr.$REGION_ID.nebius.cloud/$REGISTRY_PATH/hello-world:hello
   ```

3. Push the image to the Container Registry:

   ```bash theme={null}
   docker push cr.$REGION_ID.nebius.cloud/$REGISTRY_PATH/hello-world:hello
   ```

4. Run the image:

   ```bash theme={null}
   docker run cr.$REGION_ID.nebius.cloud/$REGISTRY_PATH/hello-world:hello
   ```