First Upload

This guide walks you through connecting R2Drop to your Cloudflare R2 bucket and uploading your first file.

Step 1: Create a Cloudflare API Token

R2Drop needs a Cloudflare API token scoped to your R2 bucket.

Open dash.cloudflare.com → My Profile → API Tokens
Click Create Token
Use the Edit Cloudflare Workers template, or create a custom token with:
- Permissions: Workers R2 Storage:Edit
- Account: your Cloudflare account
Copy the token — you'll only see it once

Security note: R2Drop stores this token exclusively in macOS Keychain. It's never written to disk or transmitted to our servers.

When you first launch R2Drop, the onboarding flow opens automatically.

If you need to add an account later: open Accounts tab → Add Account.

Paste your Cloudflare API token into the token field and click Verify.

R2Drop will validate the token against Cloudflare's API before saving it.

After token verification, configure your R2 bucket:

Account ID — your Cloudflare account ID (found in the Cloudflare dashboard sidebar)
Bucket name — the R2 bucket to upload to
Path prefix (optional) — a subfolder within the bucket (e.g., uploads/)
Custom domain (optional) — a domain you've connected to this R2 bucket (e.g., cdn.example.com)

Once onboarding is complete, upload a file using any method:

Drag to menu bar: Drop a file onto the R2Drop icon in your menu bar.

Drag into the app: Drop files directly into the Uploads tab.

Finder right-click: Right-click any file in Finder → Send to R2

Once the upload completes, the public URL is automatically copied to your clipboard.

You can also find it in the History tab by clicking any completed upload.

Last updated 5 hours ago