Skip to main content

MinIO Client

Overview​

MinIO Client (mc) is a powerful command-line tool for managing S3-compatible object storage. It provides advanced features for file operations, bucket management, and automation. MinIO Client is available for Windows, macOS, and Linux.

How to Connect MinIO Client to Vietnix Cloud S3 Storage​

Follow these steps to configure MinIO Client (mc) for Vietnix Cloud S3:

1. Download and Install MinIO Client​

  • Visit https://min.io/download#/mc to download the latest version for your operating system.
  • Follow the installation instructions for your platform.

2. Get Your Vietnix S3 Credentials​

You will need:

  • Access Key
  • Secret Key
  • Endpoint URL (e.g. https://s3.vn-hcm-1.vietnix.cloud)
  • Bucket Name

Find these details in your Vietnix Cloud Portal.

3. Configure MinIO Client​

Add your Vietnix S3 storage as an alias:

mc alias set vietnix https://s3.vn-hcm-1.vietnix.cloud YOUR_ACCESS_KEY YOUR_SECRET_KEY

Replace YOUR_ACCESS_KEY and YOUR_SECRET_KEY with your actual credentials.

4. Test the Connection​

List buckets:

mc ls vietnix

List objects in a bucket:

mc ls vietnix/your-bucket-name

5. Common Operations​

  • Upload a file: 
    mc cp ./local-file.txt vietnix/your-bucket-name/local-file.txt
  • Download a file: 
    mc cp vietnix/your-bucket-name/remote-file.txt ./remote-file.txt
  • Sync a folder: 
    mc mirror ./local-folder vietnix/your-bucket-name

Refer to the MinIO Client documentation for advanced usage and options.

note
  • Keep your credentials secure and rotate them regularly.
  • If you encounter issues, double-check your endpoint URL and credentials.
  • For advanced features and troubleshooting, see the MinIO Client documentation.