MinIO Client (mc)

The MinIO Client (mc) is a command-line tool for managing object storage services. It supports MinIO, Amazon S3, and other S3-compatible services. As RustFS is S3-compatible, you can use mc to manage RustFS objects.

Prerequisites:

• An available RustFS instance. Refer to the Installation Guide.
• The mc tool is installed.
• Available access keys.

Using mc with RustFS

First, configure an alias for RustFS using the mc alias command:

mc alias set rustfs http://12.34.56.78:9000 ACCESS_KEY SECRET_KEY

Output:

Added `rustfs` successfully.

You can now use mc with the rustfs alias to create/delete buckets, upload/download files, etc.

List Buckets

List all buckets:

mc ls rustfs

Output:

[2025-08-01 10:46:24 CST]     0B bucket-creation-by-api/
[2025-07-29 09:15:35 CST]     0B rustfs-demo/
[2025-08-03 09:44:45 CST]     0B bucket-creation-by-ui/

Create Bucket

Create a bucket:

mc mb rustfs/bucket-creation-by-mc

Output:

Bucket created successfully `rustfs/bucket-creation-by-mc`.

Delete Bucket

Delete a bucket:

mc rb rustfs/bucket-creation-by-mc

Output:

Removed `rustfs/bucket-creation-by-mc` successfully.

Upload File

Upload a file to a bucket:

mc cp file_name rustfs/bucket-creation-by-mc

Output:

...path/to/file_name: 4 B / 4 B  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓  12 B/s 0s%

Delete File

Delete a file from a bucket:

mc rm rustfs/bucket-creation-by-mc/file_name

Output:

Removed `rustfs/bucket-creation-by-mc/1.txt`.

Download File from Storage

Use mc get command to download a file from a bucket:

mc get rustfs/bucket-creation-by-mc/file_name ./file_name

Response:

...eation-by-mc/file_name: 4 B / 4 B  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓  18 B/s 0s%