Create a Bucket

This guide explains how to create buckets using the RustFS UI, rc, or the S3 API.

RequirementsCopy Anchor Link

• A running RustFS instance (see Installation Guide).
• rc installed and configured with an alias for the command-line workflow.

Use the RustFS ConsoleCopy Anchor Link

1. Log in to the RustFS Console.
2. On the Buckets page, in the top right corner, select Create Bucket.
3. Enter a bucket name and select Create.

Using rcCopy Anchor Link

See the rc guide for installation and alias configuration.

Create a bucket:

rc bucket create rustfs/my-bucket
rc bucket list rustfs/

✓ Bucket 'rustfs/my-bucket' created successfully.

Using the APICopy Anchor Link

Create a bucket via API:

PUT /{bucketName} HTTP/1.1

S3 requests must be signed with AWS Signature V4, so use an S3 client rather than hand-crafting headers. With the AWS CLI configured for your access keys:

aws s3api create-bucket \
  --bucket bucket-creation-by-api \
  --endpoint-url http://localhost:9000

Confirm that the bucket appears in the RustFS Console.