Skip to main content
Nebius AI Cloud provides a unified command-line interface (CLI) for automating your resource management. It helps you efficiently handle repetitive tasks and scale workloads directly from the terminal.

​
Install the Nebius AI Cloud CLI

The old installer script (https://storage.ai.nebius.cloud/nebius/install.sh) has been deprecated. If you got an error trying to update the Nebius AI Cloud CLI, please reinstall it using the new script: .
The Nebius AI Cloud CLI is available for both Ubuntu and macOS.
  1. Open your terminal and run the command: 
    curl -sSL https://storage.eu-north1.nebius.cloud/cli/install.sh | bash
  2. Restart your terminal or run exec -l $SHELL to complete the installation.
  3. Make sure that the installation is successful. Run: 
    nebius version
    In the output, you’ll see the version number of your Nebius AI Cloud CLI.

​
Configure the Nebius AI Cloud CLI

Use one profile per projectCreate a separate Nebius AI Cloud CLI profile for each project to ensure correct region-specific configuration.
  1. Copy your project ID from the web console Project settings and save it to an environment variable: 
    export NB_PROJECT_ID=<project_ID>
  2. Run the following command: 
    nebius profile create --parent-id $NB_PROJECT_ID
  3. Set up the new profile:
    1. Using arrow keys, select Create a new profile and press Enter.
    2. Specify the profile name and press Enter.
    3. Keep the default value for Select api endpoint (api.nebius.cloud) and press Enter.
    4. Under Select authorization type, keep federation and press Enter.
    5. Keep the default value for Select federation endpoint (auth.nebius.com) and press Enter.
    6. In the browser tab that opens, log into the Nebius AI Cloud web console if prompted. After logging in (or if you have already been logged in), you will see the following message: 
      Login is successful, you may close the browser tab and go to the console
    7. Close the browser tab and go back to your terminal window. You’ll see the message: 
      Profile "<profile-name>" configured and activated
  4. Check that your new profile has been created and set as the default one: 
    nebius profile list
    You should see the following output: 
    default
<profile-name> [default]

​
What’s next

Create your first resources using the Nebius AI Cloud CLI: