Quickstart
Create a bucket in the dashboard, then upload and list your first object with the aws CLI, rclone, or the MinIO client.
1. Create a bucket
Open Cloud Studio in the portal and pick Basin.
Give the bucket a name, set a capacity in GB, and optionally turn on versioning. Click Create and wait for the bucket to finish provisioning.
Copy the Access Key and Secret Key now: the secret is shown exactly
once. Note the full bucket name too, it is prefixed for you (for example
t1a2b3c4-media), and that full name is what your tools must use.
Store the credentials in environment variables, never in code:
export S3_ACCESS_KEY="YOUR_ACCESS_KEY"
export S3_SECRET_KEY="YOUR_SECRET_KEY"
export S3_BUCKET="YOUR_BUCKET" # the full name shown in the dashboard2. Point a client at the endpoint
The service is S3-compatible, so any S3 tool works once you set the endpoint,
the me-central-1 region, and path-style addressing. Credentials issued
before the region rename show damm-1; it's a permanent alias for
me-central-1, so a saved config keeps working unchanged.
# aws CLI v2. Set path-style once, then pass --endpoint-url on each call.
aws configure set aws_access_key_id "$S3_ACCESS_KEY"
aws configure set aws_secret_access_key "$S3_SECRET_KEY"
aws configure set region me-central-1
aws configure set default.s3.addressing_style path# ~/.config/rclone/rclone.conf
[alawadi]
type = s3
provider = Other
access_key_id = YOUR_ACCESS_KEY
secret_access_key = YOUR_SECRET_KEY
endpoint = https://basin.alawadi.cloud
region = me-central-1
force_path_style = true# MinIO client. --path on forces path-style addressing.
mc alias set alawadi https://basin.alawadi.cloud \
"$S3_ACCESS_KEY" "$S3_SECRET_KEY" --api s3v4 --path on3. Upload and list your first object
echo "hello alawadi" > hello.txt
aws --endpoint-url https://basin.alawadi.cloud \
s3 cp hello.txt "s3://$S3_BUCKET/hello.txt"
aws --endpoint-url https://basin.alawadi.cloud \
s3 ls "s3://$S3_BUCKET/"echo "hello alawadi" > hello.txt
rclone copy hello.txt "alawadi:YOUR_BUCKET/"
rclone ls "alawadi:YOUR_BUCKET/"echo "hello alawadi" > hello.txt
mc cp hello.txt "alawadi/YOUR_BUCKET/hello.txt"
mc ls "alawadi/YOUR_BUCKET/"That is a live object in your bucket. Download it back the same way
(s3 cp in reverse, rclone copy, or mc cp), or wire it into a running app
with the Connect an app to object storage guide.
Large files upload in parts
A single upload part is capped at 95 MB at the edge. For larger objects,
your tool automatically switches to a multipart upload, splitting the
object into parts and reassembling it: aws s3 cp, rclone, mc, and every
S3 SDK do this for you. See
limits and errors for the details.
Next: buckets · access keys · billing.
Basin overview
S3-compatible object storage in the live UAE region for backup files, media, static assets, and app data, with explicit current durability limits.
Buckets
How buckets are named and prefixed, how capacity and quota work, what versioning does, and why deleting a bucket is permanent and immediate.