AdministrationData ManagementBucket

RustFS Bucket Creation

Create buckets using the RustFS UI, rc, or the S3 API.

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

Requirements

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

Using the RustFS UI

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

bucket creation

Using rc

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 API

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

Verify the bucket creation in the RustFS Console.

On this page