RustFS Bucket Deletion

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

RequirementsCopy Anchor Link

• Install and configure rc before using the command-line workflow.
• Empty the target bucket before deleting it, or use --force only after reviewing the objects that will be removed.

:::warning[Deletion is permanent] Deleting a bucket is irreversible and can break applications that depend on it. Back up any data you need before you continue. :::

Using the RustFS UICopy Anchor Link

1. Log in to the RustFS Console.
2. On the homepage, select the bucket you want to delete.
3. On the far right, select the Delete button.
4. In the confirmation dialog, select Confirm.

Using rcCopy Anchor Link

See the rc guide for installation and alias configuration.

Delete a bucket:

rc bucket remove rustfs/my-bucket

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

Using the APICopy Anchor Link

Delete a bucket via API:

DELETE /{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 delete-bucket \
  --bucket bucket-creation-by-api \
  --endpoint-url http://localhost:9000

Verify the bucket deletion in the RustFS Console.