BucketMate
Providers

Cloudflare R2

Step-by-step guide to connect Cloudflare R2 buckets to BucketMate Web in your browser with an R2 S3 API token, your account endpoint, and CORS rules.

BucketMate Web connects to Cloudflare R2 through the S3-compatible API endpoint for your account. Make sure the companion browser extension is connected before testing the connection.

Prerequisites

  • Cloudflare account
  • R2 bucket
  • Account ID
  • R2 API token with access key ID and secret access key
  • BucketMate browser extension

Endpoint and region

Use your account-specific endpoint:

https://<account-id>.r2.cloudflarestorage.com

Set region to:

auto

Permissions

Give the token access to the buckets you want to manage. BucketMate Web may need permission to list buckets, list objects, read objects, write objects, and delete objects depending on the actions you use.

If the token is scoped to specific buckets and cannot list all buckets, add bucket names in Explicit buckets.

Connection steps

  1. Open the Cloudflare dashboard.
  2. Go to R2 and create or select an API token for S3 access.
  3. Copy the account ID, access key ID, and secret access key.
  4. Open BucketMate Web.
  5. Confirm the extension shows Connected in Settings > Advance.
  6. Choose Add connection.
  7. Select Cloudflare R2.
  8. Enter the endpoint https://<account-id>.r2.cloudflarestorage.com.
  9. Keep region auto.
  10. Enter the access key ID and secret access key.
  11. Use Test Connection.
  12. Choose Save Connection.

Common issues and fixes

Region must be auto

R2 expects auto. Fix by setting the region to auto.

ACL headers are not supported

Requests using x-amz-acl will fail. Fix by removing ACL headers and using R2 access controls instead of S3 ACL calls.

Object Lock is not supported

Object Lock headers are not implemented. Fix by removing Object Lock headers and using provider-native retention controls if required.

R2 buckets are private by default. Copy URL in BucketMate Web creates a presigned URL that works for 1 hour, so it opens private objects. For longer access, create a share link. Plain object URLs outside BucketMate Web work only for public objects.

BucketMate Web tips

  • Use presigned links for private one-off sharing.
  • Use explicit bucket names for restricted R2 tokens.
  • Store credentials as encrypted values when using a shared browser profile.