BYOS (Bring Your Own Storage)

BYOS mode uploads assets directly to your own infrastructure. No Reshot account required.

Storage integrations — On the hosted plan, storage destinations and delivery integrations live in project settings — BYOS uses the same config shape locally without the hosted dashboard.

AWS S3

Upload assets to an S3 bucket:

JSON

{
  "storage": {
    "type": "s3",
    "bucket": "my-company-assets",
    "region": "us-east-1",
    "pathPrefix": "docs/v2",
    "publicDomain": "https://assets.mycompany.com"
  }
}

Required Environment Variables

Terminal

AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key

Configuration Options

Property	Description
`bucket`	S3 bucket name
`region`	AWS region
`pathPrefix`	Optional path prefix for all assets
`publicDomain`	Public URL for accessing assets

Cloudflare R2

Upload assets to R2 storage:

JSON

{
  "storage": {
    "type": "r2",
    "bucket": "my-assets",
    "accountId": "your-cloudflare-account-id",
    "publicDomain": "https://pub-r2.mycompany.com"
  }
}

Required Environment Variables

Terminal

R2_ACCESS_KEY_ID=your-r2-access-key
R2_SECRET_ACCESS_KEY=your-r2-secret-key

Local Filesystem

Copy assets to a local directory (great for Git-committed assets or static site deployments):

JSON

{
  "storage": {
    "type": "local",
    "outputDir": "./public/reshot-assets",
    "publicDomain": "/reshot-assets"
  }
}

This is perfect for:

Committing assets to Git
Deploying with Vercel/Netlify
Self-hosted documentation sites

What BYOS Does Not Include

BYOS is a storage-only path. Platform features like Unbreakable URLs, Review Queue, Version History, and CDN Delivery are not available — those require Platform Mode.

Feature	Platform	S3/R2	Local
Unbreakable URLs	✓	✗	✗
Review Queue	✓	✗	✗
Version History	✓	✗	Git
CDN Delivery	✓	Configure	Host
No Account Required	✗	✓	✓