Installing MinIO Client

Installing and setting up MinIO Client

Reviewed on 15 June 2023 • Published 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.

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.
Run mc --help to make sure it was properly installed.
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
```
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.