Knowledge Base

Connecting S3 Clients to Your Bucket

Any S3-compatible application can use your bucket. Every tool needs the same four values, all found in your service tabs:

  • Endpoint — Bucket Options tab, "Server Host" (e.g. https://s3.example.com).
  • Region — Bucket Options tab, "Server Region".
  • Bucket name — Bucket Options tab.
  • Access key ID + secret key — Access Keys tab. Create a separate key per tool so you can revoke one without breaking the rest; the secret is shown only once.

Most tools also need path-style addressing turned on (the bucket travels in the URL path, not the hostname). Look for options named "path style", "virtual host style: off" or similar.

rclone (sync & backups, all platforms)

Run rclone config, choose s3 as the type and Other as the provider, then enter your keys, region and endpoint. Or add this to rclone.conf:

[mystorage]
type = s3
provider = Other
access_key_id = YOUR_ACCESS_KEY
secret_access_key = YOUR_SECRET_KEY
region = YOUR_REGION
endpoint = https://s3.example.com
force_path_style = true

Test with rclone ls mystorage:your-bucket-name.

AWS CLI

aws configure          (enter key, secret, region)
aws s3 ls s3://your-bucket-name --endpoint-url https://s3.example.com

Cyberduck / WinSCP (graphical)

  • Cyberduck: new bookmark > profile "Amazon S3", server = your endpoint host, port 443, enter access key + secret. In the path field, enter your bucket name.
  • WinSCP: new site > protocol "Amazon S3", host name = your endpoint host, then your key + secret. Set "URL style: Path" under Advanced > Environment > S3.

s3cmd

s3cmd --configure      (enter key, secret; set the endpoint as host_base and host_bucket)

Use host_base = s3.example.com and host_bucket = s3.example.com/%(bucket) — the second value is what enables path-style.

Troubleshooting

  • "Bucket not found" / certificate errors — path-style is off; enable it.
  • "Access denied" — key deleted or secret wrong; check the Access Keys tab and create a fresh key if in doubt.
  • "Quota exceeded" on upload — the bucket is full; free space or upgrade the quota from the Usage tab.
  • You can only see and use your own bucket — listing "all buckets" returns just yours or nothing, depending on the tool.
Please rate this article to help us improve our Knowledge Base.

0 0