Suggest an edit

Installing and setting up MinIO Client

Reviewed on 18 December 2023Published on 25 August 2021

MinIO Client (mc) is a command-line tool that allows you to manage your s3 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.


    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

    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

    And all commands detailed via mc --help.

Docs APIScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCarreer
© 2023-2024 – Scaleway