MinIO Client (mc)

The MinIO Client, mc, is a command-line tool for S3 storage. It browses, uploads, downloads and mirrors Zata buckets directly. You only need the client: a MinIO server is separate storage of its own and does not show your Zata buckets.

Before you start

• A bucket. See Create a bucket.
• An access key and secret key from the same region as the bucket. See Access keys.

Connection settings

Install mc

On Linux (x86_64):

curl -fL https://dl.min.io/aistor/mc/release/linux-amd64/mc -o mc
sudo install mc /usr/local/bin/mc
mc --version

For Windows, macOS or ARM Linux, download mc from dl.min.io/aistor/mc/release.

Add Zata as an alias

An alias is mc’s name for a saved connection. Replace the two keys with yours. For Mumbai, use https://bom01.zata.ai.

mc alias set zata https://idr01.zata.ai YOUR_ACCESS_KEY YOUR_SECRET_KEY --api S3v4 --path on

--api S3v4 uses Signature V4, and --path on turns on path-style addressing.

On a shared server, type the keys hidden instead, so that they never land in your shell history:

read -rsp "Access key: " ZATA_KEY; echo
read -rsp "Secret key: " ZATA_SECRET; echo
mc alias set zata https://idr01.zata.ai "$ZATA_KEY" "$ZATA_SECRET" --api S3v4 --path on
unset ZATA_KEY ZATA_SECRET

Test it

Replace my-bucket with your bucket name:

echo "hello from mc" > test.txt
mc cp test.txt zata/my-bucket/test.txt
mc ls zata/my-bucket/
mc cp zata/my-bucket/test.txt ./downloaded-test.txt

mc ls zata lists your buckets. A sub-user’s key may show none; use the bucket name directly.

Mirror a folder

mc mirror ./my-folder zata/my-bucket/my-folder

mc mirror uploads new and changed files. With --remove, it also deletes files in Zata that are not in the local folder, so try it on a small folder first.

What works on Zata

Measured with mc RELEASE.2026-09-19:

Troubleshooting

For other errors, see Access denied and Wrong endpoint or region.