Skip to main content

Cloudflare

Connect Cloudflare R2 to make an existing bucket available to staff, partners, and applications through Files.com. Files.com uses R2's S3-compatible API over HTTPS. The connection requires the bucket name, its account endpoint, and R2 access credentials.

A Mount lets people work with the bucket's files through Files.com permissions and apps. A Sync delivers a separate copy between the bucket and another location. R2 remains the storage provider in either arrangement.

Bucket Endpoint and Credentials

Select Cloudflare when adding a Remote Server and give the connection an identifiable internal name.

SettingValue
BucketThe R2 bucket name, shown under R2 > Overview in the Cloudflare portal.
EndpointThe bucket's S3 API URL from Settings > Bucket Details, with the bucket name removed from the end.
Access KeyThe R2 Access Key ID associated with the connection's API token.
Secret KeyThe Secret Access Key corresponding to that ID.

The endpoint and bucket are separate settings. Including the bucket in both gives Files.com the wrong address for file operations.

Enter credentials directly or select them from the Remote Server Credential Manager. Cloudflare exposes R2 credentials under R2 > Overview > Manage R2 API Tokens and My Profile > API Tokens. Scope access to the bucket and operations the workflow needs.

The connection offers dedicated-IP routing and regional-routing choices. Network restrictions must also permit any direct client transfers.

Transfers and File Behavior

Eligible client uploads and downloads use Direct Routing automatically. This avoids relaying the contents through Files.com and counting those contents as Files.com Transfer Usage. Web uploads relay through Files.com. Required processing, buffering, and client compatibility also affect the route.

R2 uses case-sensitive object names and a flat namespace. Object Storage Behavior explains how Files.com presents folders and carries out moves and replacements. Resolve capitalization collisions when transferring to a case-insensitive destination.

Cloudflare R2 does not provide object versioning. Plan recovery separately rather than assuming that an overwritten or deleted file remains available as an earlier R2 version.