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 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
. -