Storage
S3-compatible object storage for Scalix Cloud to create buckets and upload, list, download, and delete objects through the CLI or REST API.
Overview
Scalix Storage provides S3-compatible object storage. Upload files, serve static assets, and manage buckets through a unified API.
CLI
# Create a bucket
scalix-cloud storage mb scalix://my-bucket
# Upload a file
scalix-cloud storage cp ./image.png scalix://my-bucket/images/
# List files
scalix-cloud storage ls scalix://my-bucket/images/
# Download a file
scalix-cloud storage cp scalix://my-bucket/images/image.png ./downloaded.png
# Remove a file
scalix-cloud storage rm scalix://my-bucket/images/image.png
# Remove a bucket
scalix-cloud storage rb scalix://my-bucketREST API
Create a bucket
curl -X POST https://api.scalix.world/v1/storage/buckets \
-H "Authorization: Bearer $SCALIX_API_KEY" \
-d '{"name": "my-bucket"}'Upload
curl -X PUT https://api.scalix.world/v1/storage/buckets/my-bucket/objects/images/photo.jpg \
-H "Authorization: Bearer $SCALIX_API_KEY" \
-H "Content-Type: image/jpeg" \
--data-binary @photo.jpgObjects are stored exactly as sent — raw bytes, never re-encoded. Send the binary itself:
curl --data-binary @file, aBlob/File/Uint8Arraybody in the browser or Node, or the SDK'sputObjectwith aBlob. NeverJSON.stringifya NodeBuffer(or use a client'sjson:body option) for binary payloads: that stores the literal text{"type":"Buffer","data":[…]}as your object — a 70-byte PNG becomes 224 bytes of JSON — and the reportedsize_byteswill be the wrapper's size, not your file's. The platform cannot unwrap it for you on read because it cannot distinguish that from a legitimately stored JSON document.
Download
curl https://api.scalix.world/v1/storage/buckets/my-bucket/objects/images/photo.jpg \
-H "Authorization: Bearer $SCALIX_API_KEY" \
-o photo.jpgList objects
curl "https://api.scalix.world/v1/storage/buckets/my-bucket/objects?prefix=images/" \
-H "Authorization: Bearer $SCALIX_API_KEY"Presigned URLs
Generate a time-limited URL for direct upload or download without sharing your API key. Expiry is capped at 7 days. Requires an S3-compatible storage backend.
curl -X POST https://api.scalix.world/v1/storage/presign \
-H "Authorization: Bearer $SCALIX_API_KEY" \
-d '{
"bucket": "my-bucket",
"key": "images/photo.jpg",
"method": "PUT",
"expires_secs": 3600
}'Migration
Import from existing cloud storage:
scalix-cloud migrate storage sync \
--source-endpoint https://s3.amazonaws.com \
--source-bucket my-aws-bucket \
--source-access-key AKIA... \
--source-secret-key ... \
--target-bucket my-bucketWorks with any S3-compatible source (AWS S3, Google Cloud Storage, MinIO, and others).