MinIO Client

Last update: June 04 2026

MinIO Client is a command-line interface that supports connection to S3-compatible cloud services and provides modern alternatives to classic UNIX commands for working with files and folders.

Set up MinIO Client

1. Configure S3 access.
2. Install the client.
3. Configure the client.

1. Configure S3 access

Access can be configured by the Account Owner or a user with the iam.admin role.

1. Create a service user with a role with S3 access. If you use a service user with the s3.user, object_storage_user, or s3.bucket.user role, an access policy must be configured for the bucket, and its rules must allow access to this user.
2. Issue an S3 key to the user.

2. Install the client

Linux

1. Open the CLI.

2. Install the client:

   curl https://dl.min.io/client/mc/release/linux-amd64/mc \
       --create-dirs \
       -o $HOME/minio-binaries/mc
   
   chmod +x $HOME/minio-binaries/mc
   export PATH=$PATH:$HOME/minio-binaries/

Windows

1. Download MinIO Client from the official website of the developer.

2. Add the MinIO Client folder to the PATH variable:

   2.1. In the Windows search bar, type Edit the system environment variables.

   2.2. Click Environment Variables.

   2.3. Select the PATH variable.

   2.4. Click Edit → New.

   2.5. Add the path to the folder to the list.

   2.6. Click OK → OK.

3. To apply the environment variable settings, restart your device.

4. Verify that the client is installed:

   4.1. Open PowerShell.

   4.2. Verify that the client is installed:

   mc --version

5. If a certificate verification error occurs, to establish a secure connection:

   5.1. In your browser, go to https://<s3_domain>. Specify <s3_domain> — S3 API domain depending on the pool where your bucket is located.

   5.2. In the address bar, click and download the certificate.

   5.3. Download the certificate and save it on the server.

   5.4. Open the certificate file.

   5.5. Open the Details tab.

   5.6. Click Copy to File.

   5.7. Save the file in Base-64 encoded X.509 format (.cer).

macOS

MinIO Client is installed using the Homebrew package manager.

1. Open Terminal.

2. Install the client:

   brew install minio/stable/mc

3. Configure the client

1. Add an alias:

   mc alias set <alias_name>  https://<s3_domain>

   Specify:

   • <alias_name> — a name for the alias (connection);
   • <s3_domain> — the S3 API domain. The domain depends on the pool where S3 is located.

2. In the Enter Access Key field, specify the value of the Access key field from your S3 key.

3. In the Enter Secret Key field, specify the value of the Secret key field from your S3 key.

4. Test the connection:

   mc ls <alias_name>

   Specify <alias_name> — the alias name.

   A list of buckets will appear in the response.

Working with MinIO Client

List aliases

1. Open the CLI.

2. List the aliases:

   mc alias list

Add an alias

1. Open the CLI.

2. Add an alias:

   mc alias set <alias_name> https://<s3_domain>

   Specify:

   • <alias_name> — the alias name, which can be found using the mc alias list;
   • <s3_domain> — the S3 API domain. The domain depends on the pool where S3 is located.

Delete an alias

1. Open the CLI.

2. Delete an alias:

   mc alias remove <alias_name>

   Specify <alias_name> — the alias name, which can be found using the mc alias list.

Create a bucket

For your information

Using MinIO Client, you can only create a bucket with the Standard storage class.

If you need a different storage class, create the bucket using other tools or the Control Panel.

1. Open the CLI.

2. Create a bucket:

   mc mb <alias_name>/<bucket_name>

   Specify:

   • <alias_name> — the alias name, which can be found using the mc alias list;
   • <bucket_name> — the bucket name.

   A private bucket will be created.

3. Optional: change the bucket type to public.

List buckets

1. Open the CLI.

2. List the buckets:

   mc ls <alias_name>

   Specify <alias_name> — the alias name, which can be found using the mc alias list.

Enable versioning

1. Open the CLI.

2. Enable versioning:

   mc version enable <alias_name>/<bucket_name>

   Specify:

   • <alias_name> — the alias name, which can be found using the mc alias list;
   • <bucket_name> — the bucket name.

Suspend versioning

1. Open the CLI.

2. Suspend versioning:

   mc version suspend <alias_name>/<bucket_name>

   Specify:

   • <alias_name> — the alias name, which can be found using the mc alias list;
   • <bucket_name> — the bucket name.

List the objects in a bucket

1. Open the CLI.

2. List the objects in the bucket:

   mc ls <alias_name>/<bucket_name>

   Specify:

   • <alias_name> — the alias name, which can be found using the mc alias list;
   • <bucket_name> — the bucket name.

Upload an object

1. Open the CLI.

2. Upload an object:

   mc cp "/<local_path>" "<alias_name>/<bucket_name>/<object_name>"

   Specify:

   • <local_path> — the path to the file on your device;
   • <alias_name> — the alias name, which can be found using the mc alias list;
   • <bucket_name> — the bucket name;
   • <object_name> — the name under which the object will be uploaded.

Download an object or folder

1. Open the CLI.

2. Download an object or folder:

   mc cp "<alias_name>/<bucket_name>/<path>" "/<download_path>"

   Specify:

   • <alias_name> — the alias name, which can be found using the mc alias list;
   • <bucket_name> — the bucket name;
   • <path> — the path to the object or folder in the S3 bucket;
   • <download_path> — the path to the folder on your device where the object or folder will be downloaded.

Delete an object or folder

1. Open the CLI.

2. Delete an object or folder:

   mc rm "<alias_name>/<bucket_name>/<path>"

   Specify:

   • <alias_name> — the alias name, which can be found using the mc alias list;
   • <bucket_name> — the bucket name;
   • <path> — the path to the object or folder in the S3 bucket.