docs/source/reference/minio-mc/mc-rb.rst

mc rb

minio

Table of Contents

mc rb

Syntax

The mc rb command removes one or more buckets on MinIO or another S3-compatible service.

To remove only the contents of a bucket, use mc rm instead.

Important

mc rb permanently deletes bucket(s) on the target deployment, including any and all object versions <minio-bucket-versioning> and bucket configurations such as lifecycle management <minio-lifecycle-management> or replication <minio-bucket-replication-serverside>.

You can also use mc rb against the local filesystem to produce similar results to the rm --rf commandline tool.

EXAMPLE

The following command removes the mydata bucket on the myminio MinIO deployment:

mc rb --force myminio/mydata

SYNTAX

The command has the following syntax:

mc [GLOBALFLAGS] rb             \
                 --force        \
                 [--dangerous]  \
                 ALIAS [ALIAS...]

Parameters

ALIAS

Required The alias <alias> of a MinIO or other S3-compatible service and the full path to the bucket to remove. For example:

mc rb --force myminio/mydata

Omit the bucket path to perform a site-wide removal of buckets on the MinIO deployment. This operation requires specifying ~mc rb --dangerous to explicitly acknowledge the permanent removal of all data on the deployment. For example:

mc rb --force --dangerous myminio

For removing a directory and its contents on a local filesystem, specify the full path to that directory. The ~mc rb --force flag is ignored if specified. For example:

mc rb ~/data/myolddata

You can specify multiple ALIAS targets consisting of either MinIO or local filesystem directories. The command attempts to remove all specified targets. For example:

mc rb --force myminio/mydata ~/data/myolddata

--force

Required Safety flag to confirm removal of the bucket contents.

--dangerous

Optional Directs mc rb to perform a site-wide removal of all buckets on each specified ~mc rb ALIAS (e.g. myminio/).

If any ALIAS specifies a filesystem directory, this option results in the removal of all subdirectories and files at that directory path similar to rm --rf.

Warning

Running mc rb --dangerous is irreversible. Exercise all possible due diligence in ensuring the command applies to only the desired ALIAS targets prior to execution.

Global Flags

Example

Remove a Bucket

mc rb --force ALIAS/PATH

• Replace ALIAS <mc rb ALIAS> with the alias <mc alias> of a configured S3-compatible host.
• Replace PATH <mc rb ALIAS> with the path to the bucket to remove.

Behavior

S3 Compatibility