Connecting S3 Tooling

Every S3 client needs the same values from Storm Buckets. Find them on any
bucket's page under Connection, or in the Admin Key panel when you create a
bucket.

The credential you put here can be either kind of key. A per-bucket key
connects a client to one bucket. An account key connects your tooling to
your whole account, and it is the one you use entirely outside the dashboard.

The key model is in Managing Access Keys.

Canonical Values

The region is always the literal string storm, wherever your bucket lives. The endpoint URL is what selects the node.

Path-style required. Storm Buckets uses path-style URLs (endpoint/bucket),
not virtual-hosted style. Turn on "force path style" if your client has the option.

rclone

Add to ~/.config/rclone/rclone.conf:

[stormdevelopments]
type = s3
provider = Other
endpoint = https://alpha.buckets.stormdevelopments.ca
region = storm
access_key_id = YOUR_KEY_ID
secret_access_key = YOUR_SECRET
force_path_style = true

Test:

rclone ls stormdevelopments:your-bucket-name

AWS CLI

aws configure --profile stormdevelopments

Enter your key ID and secret, then set the region and endpoint:

# ~/.aws/config
[profile stormdevelopments]
region = storm
output = json
s3 =
    addressing_style = path

The addressing_style = path block is required. Without it the AWS CLI
defaults to virtual-hosted style (bucket.endpoint), which Storm Buckets
does not serve.

# ~/.aws/credentials
[stormdevelopments]
aws_access_key_id = YOUR_KEY_ID
aws_secret_access_key = YOUR_SECRET

List a bucket:

aws s3 ls s3://your-bucket-name \
  --endpoint-url https://alpha.buckets.stormdevelopments.ca \
  --profile stormdevelopments

See Managing Access Keys for rotation,
permissions, and generating scoped keys.