[wrangler] R2-3896 Add R2 local uploads command by rahulsuresh-git · Pull Request #11867 · cloudflare/workers-sdk

rahulsuresh-git · 2026-01-11T07:17:04Z

Adds the wrangler r2 bucket local-uploads command to manage local uploads configuration for R2 buckets. When enabled, object data is written to the nearest region first, then asynchronously replicated to the bucket's primary region.

Commands:

wrangler r2 bucket local-uploads get - Get current configuration
wrangler r2 bucket local-uploads enable - Enable local uploads
wrangler r2 bucket local-uploads disable - Disable local uploads

Flags:

-y, --force flag to skip confirmation prompt

Uses the R2 API endpoints:

GET /accounts/{account_id}/r2/buckets/{bucket_name}/local-uploads
PUT /accounts/{account_id}/r2/buckets/{bucket_name}/local-uploads

Testing 14 unit tests covering help output, get/enable/disable flows, confirmation prompts, and error cases

Tests
- Tests included/updated
- Automated tests not possible - manual testing has been completed as follows:
- Additional testing not necessary because:
Public documentation
- Cloudflare docs PR(s): LU docs cloudflare-docs#27645
- Documentation not necessary because:

A picture of a cute animal (not mandatory, but encouraged)

changeset-bot · 2026-01-11T07:17:09Z

🦋 Changeset detected

Latest commit: 332804b

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

pkg-pr-new · 2026-01-12T16:12:40Z

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@11867

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@11867

miniflare

npm i https://pkg.pr.new/miniflare@11867

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@11867

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@11867

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@11867

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@11867

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@11867

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@11867

wrangler

npm i https://pkg.pr.new/wrangler@11867

commit: 332804b

rahulsuresh-git · 2026-01-14T00:09:32Z

TODO: Remove jurisdiction changes since it is not supported.
Edit: Done

vicb

LGTM with a few minor comments

.changeset/add-local-uploads-command.md

packages/wrangler/src/r2/helpers/local-uploads.ts

packages/wrangler/src/r2/local-uploads.ts

devin-ai-integration

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 3 additional flags.

packages/wrangler/src/__tests__/r2/local-uploads.test.ts

vicb

Could you please address my inline comment and we should be good to go after that.

Thanks for your updates

rahulsuresh-git · 2026-01-30T06:38:55Z

I have the documentation PR link in description. Not sure why this check fails https://github.com/cloudflare/workers-sdk/actions/runs/21505813162/job/61964620581?pr=11867. Any idea @vicb ?

vicb · 2026-01-30T07:29:16Z

I have the documentation PR link in description. Not sure why this check fails https://github.com/cloudflare/workers-sdk/actions/runs/21505813162/job/61964620581?pr=11867. Any idea @vicb ?

CI mistery but I can add a label to bypass that, no worry to have here.

Could you please have a look at #11867 (comment)

vicb

LGTM, thanks!

Co-authored-by: Rahul Suresh <[email protected]>

rahulsuresh-git requested a review from a team as a code owner January 11, 2026 07:17

rahulsuresh-git marked this pull request as draft January 11, 2026 07:18

rahulsuresh-git changed the title ~~feat(workers-sdk): R2-3896 Add R2 local uploads to wrangler~~ [wrangler] R2-3896 Add R2 local uploads to wrangler Jan 11, 2026

rahulsuresh-git changed the title ~~[wrangler] R2-3896 Add R2 local uploads to wrangler~~ [wrangler] R2-3896 Add R2 local uploads command Jan 11, 2026

workers-devprod added this to workers-sdk Jan 12, 2026

github-project-automation bot moved this to Untriaged in workers-sdk Jan 12, 2026

rahulsuresh-git force-pushed the rahulsuresh-git/add-local-uploads-to-wrangler branch from 47f2947 to af6a5f0 Compare January 26, 2026 06:11

vicb reviewed Jan 26, 2026

View reviewed changes

rahulsuresh-git force-pushed the rahulsuresh-git/add-local-uploads-to-wrangler branch from 7ff73b4 to 1590628 Compare January 29, 2026 19:10

rahulsuresh-git marked this pull request as ready for review January 29, 2026 20:25

devin-ai-integration bot reviewed Jan 29, 2026

View reviewed changes

rahulsuresh-git force-pushed the rahulsuresh-git/add-local-uploads-to-wrangler branch from d052092 to cc90142 Compare January 29, 2026 21:56

vicb reviewed Jan 30, 2026

View reviewed changes

packages/wrangler/src/__tests__/r2/local-uploads.test.ts Outdated Show resolved Hide resolved

vicb reviewed Jan 30, 2026

View reviewed changes

rahulsuresh-git force-pushed the rahulsuresh-git/add-local-uploads-to-wrangler branch from 2547b42 to bb0c856 Compare January 30, 2026 05:40

feat(workers-sdk): R2-3896 Add R2 local uploads to wrangler

78d3af0

rahulsuresh-git force-pushed the rahulsuresh-git/add-local-uploads-to-wrangler branch from f51ae26 to 78d3af0 Compare January 30, 2026 15:28

Merge branch 'main' into rahulsuresh-git/add-local-uploads-to-wrangler

332804b

vicb added the skip-pr-description-validation Skip validation of the required PR description format label Jan 30, 2026

vicb approved these changes Jan 30, 2026

View reviewed changes

github-project-automation bot moved this from Untriaged to Approved in workers-sdk Jan 30, 2026

vicb merged commit 253a85d into cloudflare:main Jan 30, 2026
43 of 46 checks passed

github-project-automation bot moved this from Approved to Done in workers-sdk Jan 30, 2026

workers-devprod mentioned this pull request Jan 30, 2026

Version Packages #12266

Merged

petebacondarwin pushed a commit to ksawaneh/workers-sdk that referenced this pull request Feb 3, 2026

[wrangler] R2-3896 Add R2 local uploads command (cloudflare#11867)

dff71b0

Co-authored-by: Rahul Suresh <[email protected]>

Conversation

rahulsuresh-git commented Jan 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Jan 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

pkg-pr-new bot commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

rahulsuresh-git commented Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vicb left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

✅ Devin Review: No Issues Found

Uh oh!

Uh oh!

vicb left a comment

Choose a reason for hiding this comment

Uh oh!

rahulsuresh-git commented Jan 30, 2026

Uh oh!

vicb commented Jan 30, 2026

Uh oh!

vicb left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

rahulsuresh-git commented Jan 11, 2026 •

edited

Loading

changeset-bot bot commented Jan 11, 2026 •

edited

Loading

pkg-pr-new bot commented Jan 12, 2026 •

edited

Loading

rahulsuresh-git commented Jan 14, 2026 •

edited

Loading