Skip to content

S3-Compatible Storage Tools

Popular

Quake AI Object Storage is S3-compatible. Use aws-cli, s3cmd, rclone, or any S3-compatible tool. Point it at the Quake AI endpoint and use your EC2 credentials.

Credentials

S3 tools use EC2 credentials (access key + secret key), not Keystone tokens. Create them once and use across all S3 tools.

# Create EC2 credentials
openstack ec2 credentials create

# List existing credentials
openstack ec2 credentials list

Or use the Console: Storage → Object Storage → S3 Credentials. The secret is shown only once: save it immediately.

Endpoints

Each region has its own S3 endpoint. Use path-style addressing; virtual-hosted-style is not supported.

RegionEndpoint
US East 1https://object.us-east-1.rumble.cloud
US East 2https://object.us-east-2.rumble.cloud
US West 1https://object.us-west-1.rumble.cloud

AWS CLI

The standard S3 command-line tool. Install via pip install awscli or your package manager.

Configure

aws configure set aws_access_key_id YOUR_ACCESS_KEY --profile rumble
aws configure set aws_secret_access_key YOUR_SECRET_KEY --profile rumble
aws configure set region us-east-1 --profile rumble
aws configure set endpoint_url https://object.us-east-1.rumble.cloud --profile rumble

Common commands

aws s3 ls --profile rumbleList buckets
aws s3 mb s3://my-bucket --profile rumbleCreate a bucket
aws s3 cp file.txt s3://my-bucket/ --profile rumbleUpload a file
aws s3 cp s3://my-bucket/file.txt . --profile rumbleDownload a file
aws s3 sync ./dir s3://my-bucket/prefix/ --profile rumbleSync a directory
aws s3 rb s3://my-bucket --force --profile rumbleDelete bucket and contents

s3cmd

Lightweight S3 client. Install via pip install s3cmd or your package manager.

Configure (~/.s3cfg)

[default]
access_key = YOUR_ACCESS_KEY
secret_key = YOUR_SECRET_KEY
host_base = object.us-east-1.rumble.cloud
host_bucket = object.us-east-1.rumble.cloud
use_https = True

Common commands

s3cmd lsList buckets
s3cmd mb s3://my-bucketCreate a bucket
s3cmd put file.txt s3://my-bucket/Upload a file
s3cmd get s3://my-bucket/file.txt ./file.txtDownload a file
s3cmd sync ./dir/ s3://my-bucket/prefix/Sync a directory
s3cmd del s3://my-bucket/file.txtDelete an object

rclone

Multi-cloud storage tool. Install from rclone.org ↗.

Configure (~/.config/rclone/rclone.conf)

[quakeai]
type = s3
provider = Other
access_key_id = YOUR_ACCESS_KEY
secret_access_key = YOUR_SECRET_KEY
endpoint = https://object.us-east-1.rumble.cloud
acl = private

Common commands

rclone lsd quakeai:List buckets
rclone mkdir quakeai:my-bucketCreate a bucket
rclone copy file.txt quakeai:my-bucket/Upload a file
rclone copy quakeai:my-bucket/file.txt ./Download a file
rclone sync ./dir quakeai:my-bucket/prefix/Sync a directory
rclone mount quakeai:my-bucket /mnt/rumble --daemonMount as filesystem

Related

S3-Compatible API Reference →Object Storage CLI (Swift) →How to create S3 credentials →Mount S3 storage as filesystem →Migrate from AWS S3 →CORS configuration guide →
← Automation CLICLI Reference hub →