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.

​
Steps

​
Install the Nebius AI Cloud CLI

The Nebius AI Cloud CLI is available for both Ubuntu and macOS.
  1. Open your terminal and run the command:
  2. Restart your terminal or run exec -l $SHELL to complete the installation.
  3. Make sure that the installation is successful:
    In the output, you’ll see the version of your Nebius AI Cloud CLI.

​
Configure the Nebius AI Cloud CLI

After installation, configure a profile for the CLI. Use one of the supported account types:
  • A user account to manage resources from your side, as a human user.
  • A service account to authenticate resources and automate interaction with applications.
The steps below describe how to configure the CLI with your user account. If you want to work with a service account, see How to set up the CLI for a service account.
Use one profile per projectCreate a separate Nebius AI Cloud CLI profile for each project to ensure correct region-specific configuration.
To configure the CLI quickly, follow the non-interactive flow. To control the configuration process, follow the interactive flow.
  1. Create a name for the new profile in the Nebius AI Cloud CLI and save it to an environment variable:
  2. Get the project ID and save it to an environment variable:
  3. Create the CLI profile:
    If you have access to multiple tenants, you can specify the tenant that you want to use with this profile in the --tenant-id parameter. If you are added to someone else’s tenant and know the ID of its federation, you can specify it either in the --federation-id parameter, or when logging in to the Nebius AI Cloud web console after running the command.
  4. On the browser tab that opens, log in to the web console if prompted. After logging in (or if you have already been logged in), you will see the following message:
  5. Close the browser tab and go back to your terminal window. You will see the following message:
  6. Check that your new profile has been created and set as the default one:
    You should see the following output:

​
(Optional) Set up command autocompletion

During setup, your shell will enable Nebius AI Cloud CLI autocompletion by default. If it doesn’t happen, use one of the solutions below:
Run the following command:

​
What’s next

Create your first resources by using the Nebius AI Cloud CLI, for example: