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

# Managing projects in Nebius AI Cloud

Resources in Nebius AI Cloud are organized and managed within projects. When a tenant is created, a project per [region](../overview/regions) is created by default. You can additionally [create](#how-to-create-a-project) projects and [edit](#how-to-edit-a-project) existing ones.

## Prerequisites

The prerequisites for this guide depend on the interface that you use.

<Tabs>
  <Tab title="Web console">
    Make sure you are in a [group](/iam/authorization/groups/index) that has the `admin` role within your tenant; for example, the default `admins` group. You can check this in the [Administration → IAM](https://console.nebius.com/iam) section of the web console.
  </Tab>

  <Tab title="CLI">
    1. Make sure you are in a [group](/iam/authorization/groups/index) that has the `admin` role within your tenant; for example, the default `admins` group. You can check this in the [Administration → IAM](https://console.nebius.com/iam) section of the web console.

    2. [Install](../cli/install) and [configure](../cli/configure) the Nebius AI Cloud CLI.

    <Warning>
      **Use one profile per project**

      Create a separate Nebius AI Cloud CLI profile for each project to ensure correct [region](/overview/regions)-specific configuration.
    </Warning>
  </Tab>

  <Tab title="Terraform">
    [Install and configure](/terraform-provider/quickstart) the Nebius AI Cloud provider for Terraform.
  </Tab>
</Tabs>

## How to create a project

<Tabs>
  <Tab title="Web console">
    1. In the [web console](https://console.nebius.com), expand the top-left list of projects.

    2. Click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/plus.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=7c9efc69d65fc58db0eb73702fd81aa1" width="16" height="16" data-path="_assets/plus.svg" /> **Create project**.

    3. In the project creation form, specify the project settings:

       * Select the tenant and region. You cannot change them later.
       * Enter the name of the new project. The name should be unique in the tenant. You can [edit](#how-to-edit-a-project) it later.

    4. Click **Create project**.
  </Tab>

  <Tab title="CLI">
    Create a project:

    ```bash theme={null}
    nebius iam v2 project create \
      --parent-id <tenant_ID> \
      --name <project_name> \
      --region <region_name>
    ```

    The command contains the following parameters:

    * `--parent-id`: [Tenant ID](/iam/get-tenants#cli).
    * `--name`: Name of the project.
    * `--region`: Name of the [region](../overview/regions) where the project is created.

          <Warning>
            You can only create a project via the Nebius AI Cloud CLI in [public regions](../overview/regions#public-regions). If you try to create a project in a private region, you receive an error.
          </Warning>
  </Tab>

  <Tab title="Terraform">
    1. Create the following configuration file:

       ```hcl theme={null}
       resource "nebius_iam_v2_project" "<project_name>" {
         name = "<project_name>"
         parent_id = "<tenant_ID>"
         region = "<region_name>"
       }
       ```

       The resource contains the following parameters:

       * `parent_id`: [Tenant ID](/iam/get-tenants).
       * `name`: Name of the project.
       * `region`: Name of the [region](../overview/regions) where the project is created.

    2. Check that the configuration is correct:
       ```bash theme={null}
       terraform validate
       ```

    3. Apply the changes:
       ```bash theme={null}
       terraform apply
       ```
  </Tab>
</Tabs>

## How to get a project ID

To get the ID of a project:

<Tabs>
  <Tab title="Web console">
    1. In the [web console](https://console.nebius.com), expand the top-left list of projects.
    2. Next to the project's name, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/copy.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e7f23591f2e46ebae45634aa995aaa9f" width="16" height="16" data-path="_assets/copy.svg" /> **Copy project ID**.
  </Tab>

  <Tab title="CLI">
    Run the following command:

    ```bash theme={null}
    nebius iam v2 project get-by-name --parent-id <tenant_ID> --name <project_name>
    ```

    In this command, specify the parameters:

    * `--parent-id`: ID of the tenant where the project is created.
    * `--name`: Name of the project.
      If you do not know the exact name of the project, use the `list` command to view the list of all projects of your tenant:

      ```bash theme={null}
      nebius iam v2 project list --parent-id <tenant_ID>
      ```
  </Tab>

  <Tab title="Terraform">
    In your Terraform working directory, get the attributes of your project using its name:

    ```bash theme={null}
    terraform state show nebius_iam_v2_project.<project_name>
    ```

    The `id` attribute in the output contains the project ID.

    If you do not know the exact name of the project, list all the resources from your Terraform state file (`.tfstate`) to find the project name:

    ```bash theme={null}
    terraform state list                   
    ```
  </Tab>
</Tabs>

## How to edit a project

For an existing project, you can only edit the name. You cannot move a project to another region or tenant.

To edit the project name:

<Tabs>
  <Tab title="Web console">
    1. In the [web console](https://console.nebius.com), expand the top-left list of projects.
    2. In the line of the required project, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **Configure**.
    3. Enter a new value in the **Name** field.
    4. Click **Save**.
  </Tab>

  <Tab title="CLI">
    Run the following command:

    ```bash theme={null}
    nebius iam v2 project edit \
      --id <project_ID>
      [--editor '<editor_terminal_name> --wait'] \
      [--format <json|yaml>]
    ```

    In this command, specify the parameters:

    * `--id`: ID of the project.

    * `--editor` (optional): Editor name. It can be any editor installed on your machine, such as `nano` or `emacs`. To check which of the popular editors are installed, run the following command:

      ```bash theme={null}
      which code emacs gedit micro nano subl vi vim
      ```

      For an editor that opens in a separate window, add the `--wait` parameter to its name to ensure that the command waits until you close the editor.

    * `--format` (optional): Data format. Only `json` and `yaml` values are accepted. By default, YAML format is used.

    The editor you choose opens and shows the current configuration of the project. Change the project name and save the configuration. When you exit the editor, the Nebius AI Cloud CLI checks if the data is valid and updates the resource.
  </Tab>

  <Tab title="Terraform">
    1. In the configuration file, edit the `name` argument of the corresponding `nebius_iam_v2_project` resource.
    2. Check that the configuration is correct:
       ```bash theme={null}
       terraform validate
       ```
    3. Apply the changes:
       ```bash theme={null}
       terraform apply
       ```
  </Tab>
</Tabs>

## How to delete a project

Before you delete a project, make sure to remove all resources from it. You can only delete an empty project.

<Tabs>
  <Tab title="Web console">
    1. In the [web console](https://console.nebius.com), expand the top-left list of projects.
    2. In the line of the required project, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **Delete project**.
  </Tab>

  <Tab title="CLI">
    Delete the project:

    ```bash theme={null}
    nebius iam v2 project delete --id <project_ID>
    ```
  </Tab>

  <Tab title="Terraform">
    1. Remove the corresponding `nebius_iam_v2_project` resource from the configuration file.
    2. Check that the configuration is correct:
       ```bash theme={null}
       terraform validate
       ```
    3. Apply the changes:
       ```bash theme={null}
       terraform apply
       ```
  </Tab>
</Tabs>