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.

    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 fields in pointy brackets 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
  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