BYOS (Bring Your Own Storage)

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

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

PropertyDescription
bucketS3 bucket name
regionAWS region
pathPrefixOptional path prefix for all assets
publicDomainPublic 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.

FeaturePlatformS3/R2Local
Unbreakable URLs
Review Queue
Version HistoryGit
CDN DeliveryConfigureHost
No Account Required
BYOS (Bring Your Own Storage) — Reshot Docs | Reshot