Master MinIO Client (mc): Install, Configure, and Manage Buckets Quickly

Installation of MinIO Client (mc)

Docker version

docker pull minio/mc
docker run minio/mc ls play

Homebrew (macOS)

brew install minio/stable/mc
mc --help

Linux binary (GNU/Linux, 64‑bit Intel)

curl -O http://dl.minio.org.cn/client/mc/release/linux-amd64/mc
chmod +x mc
./mc --help

Windows binary (64‑bit Intel)

curl -O http://dl.minio.org.cn/client/mc/release/windows-amd64/mc.exe
mc.exe --help

Build from source (requires Go)

go get -d github.com/minio/mc
cd $GOPATH/src/github.com/minio/mc
make

Note: The mc update command does not support update notifications for source builds; download the official binary instead.

Basic usage of MinIO Client (mc)

Add a cloud storage service

mc config host add minio http://127.0.0.1:9000 minioadmin minioadmin

Replace the endpoint, access key, and secret key with your own values.

List configured hosts mc config host list Result is shown in the screenshot below.

Create a bucket mc mb minio-server/lvzhenjiang The command creates a bucket named lvzhenjiang on the minio-server alias.

List buckets mc ls minio-server Upload a file to a bucket mc cp /etc/hosts minio-server/lvzhenjiang Upload a directory recursively mc cp /etc minio-server/lvzhenjiang --recursive Delete a file from a bucket mc rm minio-server/lvzhenjiang/hosts Delete a directory recursively

mc rm minio-server/lvzhenjiang/etc --recursive --force

Remove an empty bucket mc rb minio-server/lvzhenjiang Force‑remove a bucket with contents

mc rb minio-server/lvzhenjiang --force

Common mc commands

ls

– list files and folders mb – create a bucket cat – display object content pipe – redirect STDIN/STDOUT to an object share – generate a shareable URL cp – copy files/objects mirror – mirror a bucket or folder find – search for objects diff – compare differences between buckets rm – remove files or objects events – manage object notifications watch – monitor object events policy – manage access policies config – manage mc configuration update – check for software updates version – display version information