At a Glance
Credentials
Create a secret with the Cloudflare R2 provider type. The auth method isr2_access_key, which requires:
Create an R2 API token from the Cloudflare dashboard (R2 → Manage R2 API Tokens) with
read/write permission on the bucket.
The account ID does not belong in the secret — it goes in the location’s
endpoint_url.
Location Setup
The location form asks for your Cloudflare account ID (shown on the R2 overview page in the
dashboard) and fills in the endpoint URL from it. Onboarding and the rclone.conf import review do
the same. The URL stays editable: a bucket in a jurisdiction uses that jurisdiction’s host instead,
such as
https://<account_id>.eu.r2.cloudflarestorage.com for the EU.
Example:
Provider Quirks
R2 buckets are managed through the dashboard — the API exposes noCreateBucket, so R2 locations
default to s3_no_check_bucket: true. R2 also handles list operations very efficiently, so
fast_list is on by default.
Importing from rclone.conf
R2 remotes appear inrclone.conf as type = s3 with provider = Cloudflare. If the remote has
an account_id but no endpoint, the importer builds the endpoint URL from the account ID
automatically. See the rclone import guide.