cflare r2

R2 Object Storage

Zero Egress

Manage S3-compatible, zero-egress Cloudflare R2 object storage buckets, upload files, and generate pre-signed URLs.

$ cflare r2 <list|upload|download|delete> <bucket> [options]

📖 Full Explanation

Cloudflare R2 provides reliable, S3-compatible object storage with zero data egress fees. \1 provides a native terminal client to list buckets, upload builds, download backups, and manage object storage without installing bulky AWS CLI tools.

⚙️ Command Options & Flags

Option / Flag Description Default
-f, --file <path> Local file path to upload or download -
-k, --key <object-key> Target object key name inside the bucket -
--prefix <prefix> Filter object listings by key prefix -

🔬 Technical Corollary & Edge Mechanics

Communicates directly with Cloudflare's R2 control plane API and S3-compatible endpoints using SigV4 authentication. Bypasses egress cost traps common in traditional cloud providers.

🎯 Real-World DevOps Use Cases

Static Asset Deployment

Sync compiled frontend bundles into an R2 bucket backed by a custom domain.

$ cflare r2 upload static-assets -f dist/bundle.js -k bundle-v1.js

Database Backup Storage

Store daily encrypted SQLite or Postgres backups with zero bandwidth egress penalties.

$ cflare r2 upload db-backups -f db.dump -k 2026-10-15.dump

💻 Live Output Simulation

$ cflare r2 list media-bucket
┌──────────────────────────────┬────────────┬─────────────────────┐
│ Object Key                   │ Size       │ Last Modified       │
├──────────────────────────────┼────────────┼─────────────────────┤
│ avatars/user-42.png          │ 142.8 KB   │ 2026-10-15 18:20:10 │
│ documents/report.pdf         │ 2.4 MB     │ 2026-10-15 19:12:00 │
└──────────────────────────────┴────────────┴─────────────────────┘