Skip to main content

Create Buckets

Create CoreWeave AI Object Storage buckets with Cloud Console or CLI clients.

Buckets are the primary organizational unit used to store object data in CoreWeave AI Object Storage. They are similar to folders in a file system.

This guide explains how to create a bucket with the CoreWeave Cloud Console or CLI clients such as S3cmd, AWS CLI, and Boto3.

Prerequisites

You must generate an Access Key before creating a bucket. When using the Cloud Console, use Cloud Console tokens to generate the Access Key. Workload Identity Federation is supported when using CLI clients.

Create a bucket with Cloud Console

Info
  • To create a bucket with the Cloud Console, you must have admin permissions.
  • Bucket names must be globally-unique and not begin with cw- or vip-, which are reserved for internal use.

To create a bucket with the CoreWeave Cloud Console, follow these steps:

  1. In the Cloud Console, navigate to Object Storage > Buckets.
  2. Click Create Bucket.
  3. In the dialog, enter a Bucket Name.
  4. Chose a Zone.
  5. Click Create.
  6. Click More options to view information in Grafana, or to delete the bucket.

Create a bucket with CLI clients

CoreWeave AI Object Storage is compatible with S3-compatible clients.

Info

Before creating a bucket, configure S3cmd, AWS CLI, or Boto3.

In the sections that follow:

  • Replace AVAILABILITY_ZONE with a supported Availability Zone code.
  • Replace BUCKET_NAME with a globally unique name that does not begin with cw- or vip-, as these prefixes are reserved for internal use.

Use S3cmd

To create a bucket with S3cmd, use the mb (make bucket) subcommand. The --bucket-location parameter is required.

Make a bucket with S3cmd
$
s3cmd mb --bucket-location=AVAILABILITY_ZONE s3://BUCKET_NAME

If you need to configure S3cmd for AI Object storage, see Manage buckets with S3cmd.

Use AWS CLI

To create a bucket with AWS CLI, use the aws s3api command. The LocationConstraint parameter is required.

Create a bucket with AWS CLI
$
aws s3api create-bucket \
--bucket BUCKET_NAME \
--region AVAILABILITY_ZONE \
--create-bucket-configuration LocationConstraint=AVAILABILITY_ZONE

If you need to install or configure AWS CLI for AI Object Storage, see Manage buckets with AWS CLI.

Use Boto3

To create a bucket with Boto3, use the create_bucket method. The LocationConstraint parameter is required.

Create a bucket with Boto3
response = client.create_bucket(
Bucket='BUCKET_NAME',
CreateBucketConfiguration={
'LocationConstraint': 'AVAILABILITY_ZONE',
},
)
print(response)

If you need to configure Boto3 for AI Object Storage, see Manage buckets with Boto3.

Next steps

After creating a bucket, set policies to control access, lifecycle, and auditing.