Installing and setting up MinIO Client
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 here to install the MinIO client (
mc
) for your OS.For example, on Linux:
wget https://dl.min.io/client/mc/release/linux-amd64/mcchmod +x mcNote:Make sure that you download the binary somewhere that is in your
$PATH
. -
Run
mc --help
to check it has 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 fr-par 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.fr-par.scw.cloud <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api S3v4 -
You should now be able to run some basic commands, eg:
-
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
. -