Connect Cloudflare R2

​

Prerequisites

• A Cloudflare account with R2 enabled
• An R2 bucket
• R2 API token with Object Read & Write on that bucket

​

1. Create an R2 bucket

1. Cloudflare dashboard → R2 Object Storage
2. Create bucket
3. Note the bucket name

​

2. Create an API token

1. R2 → Manage R2 API Tokens
2. Create a token with permission to read/write your bucket
3. Copy Access Key ID and Secret Access Key (secret is shown once)
4. Copy your Cloudflare Account ID (overview page)

https://<ACCOUNT_ID>.r2.cloudflarestorage.com

​

3. Add credentials in BlobRouter

1. Open Dashboard → Providers
2. Choose Cloudflare R2
3. Enter:
   • Account ID
   • Access Key ID
   • Secret Access Key
   • Bucket name
   • Region (use auto if your token uses the default R2 S3 API)
4. Save, then Test connection

​

4. Upload with hot priority

import { BlobRouter } from "@blobrouter/sdk";
import { readFileSync } from "fs";

const storage = new BlobRouter({
  apiKey: process.env.BLOBROUTER_API_KEY,
});

const file = readFileSync("./asset.png");

const result = await storage.upload(file, {
  fileName: "asset.png",
  contentType: "image/png",
  fileSizeBytes: file.length,
  priority: "hot",
});

console.log(result.provider); // "cloudflare-r2" when R2 is configured

​

Troubleshooting