Quickstart

​

Prerequisites

• A OneBucket account — request one.
• Live configuration: credentials, an endpoint, and a deployed policy connecting them together. First time here? Do the one-time setup first.
• From OneBucket console: your S3 endpoint and an access key / secret key pair.

​

Use it as S3

# Credentials
aws configure set aws_access_key_id <ACCESS_KEY>
aws configure set aws_secret_access_key <SECRET_KEY>
export OB=https://s3.onebucket.io   # global — routes to your nearest cluster

# Create a bucket, upload, list, and read back
aws --endpoint-url $OB s3 mb s3://my-first-bucket
echo "hello from onebucket" > hello.txt
aws --endpoint-url $OB s3 cp hello.txt s3://my-first-bucket/hello.txt
aws --endpoint-url $OB s3 ls s3://my-first-bucket/
aws --endpoint-url $OB s3 cp s3://my-first-bucket/hello.txt -

import boto3

s3 = boto3.client(
    "s3",
    endpoint_url="https://s3.onebucket.io",  # global — routes to your nearest cluster
    aws_access_key_id="<ACCESS_KEY>",
    aws_secret_access_key="<SECRET_KEY>",
    region_name="us-east-1",
)

s3.create_bucket(Bucket="my-first-bucket")
s3.put_object(Bucket="my-first-bucket", Key="hello.txt", Body=b"hello from onebucket")
print(s3.get_object(Bucket="my-first-bucket", Key="hello.txt")["Body"].read().decode())

​

Connect Claude

​

Manage keys and tokens (CLI)

onebucket login      # OAuth browser sign-in
onebucket keys       # list your access keys
onebucket sessions   # list or revoke active sessions
onebucket logout     # clear the stored login

​

Next steps

• Automate with AI — connect Claude for natural-language access to your data.
• Span backends — copy, migrate, and locate objects across clouds, on-prem, and edge from the same client.
• Cut egress — prefetch hot objects into the edge cache so repeat reads are served locally.