Image Sources

ImageBoss can connect with your images anywhere.

Cloudflare R2

ImageBoss can connect to images stored in Cloudflare R2 using the S3-compatible API.

Quick checklist

  • Cloudflare account with R2 enabled
  • R2 bucket containing your original images
  • S3-compatible Access Key + Secret Key with read permissions

Step 1: Create (or identify) an R2 bucket

  1. Open the Cloudflare Dashboard.
  2. Go to R2 and create a bucket (or choose an existing one).
  3. Copy the bucket name. You will use it as Bucket Name in ImageBoss.

Step 2: Create S3-compatible API credentials

  1. In Cloudflare, open R2 → Manage R2 API tokens.
  2. Create a token/key pair with read permissions for your target bucket.
  3. Save your Access Key and Secret Key.

Step 3: Add the source in ImageBoss

  1. Go to Dashboard → Sources → Add Source.
  2. Select Cloudflare R2.
  3. Fill the fields below and save.
  • Access Key: your R2 access key
  • Secret Key: your R2 secret key
  • Bucket Name: your R2 bucket
  • Account ID (optional): used to derive endpoint when Endpoint is empty
  • Endpoint (optional): explicit endpoint, e.g. https://<accountid>.r2.cloudflarestorage.com
  • Base Path (optional): prefix when images are under a folder

How endpoint resolution works

  • Mode A: use explicit endpoint
  • Mode B: omit endpoint and ImageBoss derives it from accountId

Cloudflare documents the endpoint format and S3 compatibility here: R2 S3 Get Started and R2 S3 API.

Step 4: Validate with a real image

After saving, use one known image path from your bucket and test with cdn first:

Troubleshooting

  • Confirm Access Key and Secret Key are valid and active
  • Confirm Bucket Name matches exactly
  • If using endpoint, verify full URL format including https://
  • If endpoint is empty, verify Account ID
  • Verify the object path in the URL exists in your bucket

Official references


That's it! Your R2 images are now available through your ImageBoss source.