HomeStorageObject StorageAPI/CLI
Installing MinIO Client
Update content

Installing and setting up MinIO Client

Reviewed on 15 June 2023Published on 25 August 2021
Security & Identity (IAM):

You may need certain IAM permissions to carry out some actions described on this page. This means:

  • you are the Owner of the Scaleway Organization in which the actions will be carried out, or
  • you are an IAM user of the Organization, with a policy granting you the necessary permission sets

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

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


    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:


    For example, if your Scaleway Object Storage endpoint is in the nl-ams region, you can use the following command (replace the two fields in pointy brackets with your access key and secret key):

    mc alias set s3 <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api S3v4
  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

    And all commands detailed via mc --help.

See Also