How to get started with Object Storage: Create your first bucket

Most ML/AI workloads involve large files, such as datasets and artifacts of trained models. To efficiently store, access and share them, you can use Object Storage, a simple storage service offered by Nebius AI Cloud. In this guide, you will learn how to start using Object Storage. You will set up your environment to work with Object Storage, create your first bucket, a data container, and upload a test file.

Prepare your environment

Make sure that you meet the prerequisites for your preferred interface:

Web console
Nebius AI Cloud CLI

Make sure you are in a group that has at least the editor role within your tenant; for example, the default editors group. You can check this in the Administration → IAM section of the web console.

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 certain command line interfaces (CLIs) and tools that you need to install first. Here are all the installation commands in a single copy-and-paste block:

sudo apt-get install unzip jq
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
curl -sSL https://storage.eu-north1.nebius.cloud/cli/install.sh | bash
nebius profile create

These commands will install the following:

AWS CLI (how to install) manages buckets and objects: Object Storage is compatible with Amazon S3. For Linux, the AWS CLI is distributed in a ZIP archive, so the commands also install the unzip package.
jq (how to install) parses JSON outputs from the Nebius AI Cloud CLI and extracts resource IDs for other commands.
Nebius AI Cloud CLI (how to install) manages all Nebius AI Cloud resources. In this guide, the CLI is used to create access-related resources. It can also be used for creating and modifying Object Storage buckets, but not for uploading objects.

The last command, nebius profile create, will open the Nebius AI Cloud web console sign-in screen in your browser. Sign in to the web console to complete the initialization. After that, save your project ID in the CLI configuration:

Copy your project ID from the web console:
1. Go to the web console and then expand the top list of projects.
2. Next to the project’s name, click → Copy project ID.

Add the project ID to the CLI configuration:

nebius config set parent-id <project_ID>

Configure access, credentials and AWS CLI settings

If you are using the web console, you can skip this step and proceed to creating a bucket.

Create a service account and save its ID to an environment variable:

export NB_SA_ID=$(nebius iam service-account create \
  --name object-storage-sa --format json \
  | jq -r '.metadata.id')

Grant edit access to the service account:

Get the tenant ID:

export NB_PROJECT_ID=$(nebius config get parent-id)
export NB_TENANT_ID=$(nebius iam project get $NB_PROJECT_ID --format jsonpath='{.metadata.parent_id}')

Get the ID of the default editors group:

export NB_EDITORS_GROUP_ID=$(nebius iam group get-by-name \
  --name editors --parent-id $NB_TENANT_ID \
  --format jsonpath='{.metadata.id}')

Add the service account to editors group:

nebius iam group-membership create \
  --parent-id $NB_EDITORS_GROUP_ID \
  --member-id $NB_SA_ID

Create an access key for the service account and get its AWS-like ID and contents:

export NB_ACCESS_KEY_ID=$(nebius iam access-key create \
  --account-service-account-id $NB_SA_ID \
  --description 'AWS CLI' \
  --format json | jq -r '.resource_id')
export NB_ACCESS_KEY_AWS_ID=$(nebius iam access-key get-by-id \
  --id $NB_ACCESS_KEY_ID \
  --format json | jq -r '.status.aws_access_key_id')
export NB_SECRET_ACCESS_KEY=$(nebius iam access-key get-secret-once \
  --id $NB_ACCESS_KEY_ID --format json \
  | jq -r '.secret')

Add the key to the AWS CLI configuration:

aws configure set aws_access_key_id $NB_ACCESS_KEY_AWS_ID
aws configure set aws_secret_access_key $NB_SECRET_ACCESS_KEY

Depending on your project region, add the Nebius AI Cloud region ID and the Object Storage endpoint URL to the AWS CLI configuration:

aws configure set region <region_ID>
aws configure set endpoint_url https://storage.<region_ID>.nebius.cloud

For example, run the following commands for a project in eu-north1:

aws configure set region eu-north1
aws configure set endpoint_url https://storage.eu-north1.nebius.cloud

Create a bucket and upload a file to it

In Object Storage, a bucket is a container for objects. An object, in turn, is a file together with its metadata such as the file name (it is called object key in Object Storage terms). You can use the web console or the AWS CLI to create buckets and upload objects.

Web console
AWS CLI

Create a bucket:
1. In the sidebar, go to Storage → Object Storage.
2. Click Create bucket.
3. (Optional) Specify the bucket name. The bucket name must be unique across the region. For more information, see Naming.
4. Set the bucket parameters.
5. Click Create bucket.
Upload a file to the bucket:
1. On the page of the bucket, click Add .
2. Select Object.
3. In the window that opens, select the file you want to upload.
4. Click Upload.
5. Check that the Objects tab shows the new object.

Create a bucket:
```
aws s3 mb s3://quickstart-bucket
```

Upload an object:

echo 'Hello world!' > test.txt
aws s3 cp test.txt s3://quickstart-bucket/test.txt

To make sure that the object has been uploaded, list the objects in the bucket:
```
aws s3 ls s3://quickstart-bucket
```

Object Storage

Managed Service for PostgreSQL®

Container Registry

How to get started with Object Storage: Create your first bucket

Prepare your environment

Configure access, credentials and AWS CLI settings

Create a bucket and upload a file to it

Object Storage

Managed Service for PostgreSQL®

Container Registry

​Prepare your environment

​Configure access, credentials and AWS CLI settings

​Create a bucket and upload a file to it

Prepare your environment

Configure access, credentials and AWS CLI settings

Create a bucket and upload a file to it