Quickstart

Already using S3?

Point your existing S3 client at Shelby. For most code, only the client configuration changes:

s3 = boto3.client(
    "s3",
    endpoint_url="https://s3.beta.shelby.xyz",  
    aws_access_key_id=SHELBY_ACCESS_KEY_ID,  
    aws_secret_access_key=SHELBY_SECRET_ACCESS_KEY,  
    region_name="default",  
    config=Config(
        s3={"addressing_style": "path"},  
        request_checksum_calculation="when_required",  
    ),
)

Get your bucket name, and an access key ID and secret for that bucket, at console.shelby.xyz, then follow the quickstart for your client:

Each quickstart also has a runnable version in shelby-quickstart.

Before moving a production workload, read how Shelby differs from S3.

Using an AI agent?

The MCP server gives Claude, Cursor or your own agent read and write access to your buckets, with no integration code.

Learn more

• How Shelby stores data
• Compatibility matrix