Installing and setting up MinIO Client

Reviewed on January 15, 2025

The MinIO Client (mc) is a command-line tool that allows you to manage your Object Storage projects, providing a modern alternative to UNIX commands.

Before you start

To complete the actions presented below, you must have:

• Owner status or IAM permissions allowing you to perform actions in the intended Organization.

1. Follow the instructions given in the official MinIO documentation to install the MinIO client (mc) for your OS.
   Note

   Make sure that you download the binary somewhere that is in your $PATH.

2. Run mc --help to make sure it was properly installed.
3. Follow the instructions in the MinIO quickstart guide to add a cloud storage service:
   mc alias set <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api <API-SIGNATURE>

   For example, if your Scaleway Object Storage endpoint is in the nl-ams region, you can use the following command (replace the two placeholders with your access key and secret key):
   mc alias set s3 https://s3.nl-ams.scw.cloud <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api S3v4

   Tip

   You can create an alias for each region in which you manage Object Storage resources.

4. You should now be able to run some basic commands, e.g.:

   • List all your buckets at the endpoint you configured in the previous step, via:

     mc ls s3

   • List all objects in a given bucket, via:

     mc ls s3/<your-bucket-name>

   • Remove an object from a bucket, via:

     mc rm s3/<your-bucket-name>/1.pdf

   • Access commands reference, via:

     mc --help