Table of Contents
mc mb command creates a new bucket or directory at the
You can also use
mc mb against the local filesystem to produce
similar results to the
mkdir -p commandline tool.
The following command creates a new bucket
mydata on the
myminio MinIO deployment. The command creates the bucket
with object locking enabled.
mc mb --with-locks myminio/mydata
The command has the following syntax:
mc [GLOBALFLAGS] mb \ [--ignore-existing] \ [--region "string"] \ [--with-lock] \ ALIAS
 indicate optional parameters.
Parameters sharing a line are mutually dependent.
Parameters seperated using the pipe
| operator are mutually exclusive.
Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.
Required The MinIO or other S3-compatible service on which to create the new bucket.
For creating a bucket on MinIO, specify the alias and the name of the bucket. For example:
mc mb play/mybucket
For creating a directory on a local filesystem, specify the full path to that directory. For example:
mc ls ~/mydata/object.txt
mc mb to do nothing if the bucket or directory already
The region in which to create the specified bucket. Has no effect if the
ALIAS is a filesystem directory.
The path to a
JSON formatted configuration file that
mc uses for storing data. See Configuration File for
more information on how mc uses the configuration file.
Enables JSON lines formatted output to the console.
mc --JSON COMMAND
Disables TLS/SSL certificate verification. Allows TLS connectivity to servers with invalid certificates. Exercise caution when using this option against untrusted S3 hosts.
Displays the current version of
mc mb --with-lock ALIAS/BUCKET
Certain S3 services may restrict the number of buckets a given user or account
can create. For example, Amazon S3 limits each account to
mc mb may return an
error if the user has reached bucket limits on the target S3 service.
MinIO Object Storage deployments do not place any limits on the number of buckets each user can create.
Enabling bucket locking does not set any object locking or retention settings. Consider enabling bucket locking as standard practice.
The mc commandline tool is built for compatibility with the AWS S3 API and is tested MinIO and AWS S3 for expected functionality and behavior.
MinIO provides no guarantees for other S3-compatible services, as their S3 API implementation is unknown and therefore unsupported. While mc commands may work as documented, any such usage is at your own risk.