Skip to content

[Containers] Document privileged_containers for FUSE in local dev#30462

Open
Ben2W wants to merge 1 commit into
cloudflare:productionfrom
Ben2W:fuse-enable-containers-privileged-mode
Open

[Containers] Document privileged_containers for FUSE in local dev#30462
Ben2W wants to merge 1 commit into
cloudflare:productionfrom
Ben2W:fuse-enable-containers-privileged-mode

Conversation

@Ben2W

@Ben2W Ben2W commented Apr 30, 2026

Copy link
Copy Markdown

Summary

Documents the new opt-in flag for FUSE in wrangler dev. Three files:

Image 4-30-26 at 11 33 AM Image 4-30-26 at 11 33 AM (1)
  • changelog/containers/2026-04-29-fuse-local-dev.mdx — changelog entry

Pairs with cloudflare/workerd#6596 and cloudflare/workers-sdk#13748. Resolves cloudflare/workerd#5609.

Documentation checklist

  • Changelog entry added (changelog/containers/2026-04-29-fuse-local-dev.mdx)
  • Adheres to the style guide
  • No file moves, no redirects needed

@Ben2W Ben2W force-pushed the fuse-enable-containers-privileged-mode branch from be4bfac to d9a6f71 Compare April 30, 2026 18:22
@Ben2W Ben2W changed the title [Containers] Document enable_containers_privileged_mode for FUSE in local dev [Containers] Document privileged_containers for FUSE in local dev Apr 30, 2026
@Ben2W Ben2W force-pushed the fuse-enable-containers-privileged-mode branch from d9a6f71 to cbde058 Compare May 1, 2026 07:28
@Ben2W Ben2W marked this pull request as ready for review May 1, 2026 07:47
@Ben2W Ben2W requested review from mikenomitch and th0m as code owners May 1, 2026 07:47
@Ben2W Ben2W requested a review from a team May 1, 2026 07:47
@Ben2W Ben2W requested review from a team as code owners May 1, 2026 07:47
@@ -30,6 +30,14 @@ Common use cases where this tradeoff is acceptable include reading shared assets

:::

:::caution[FUSE in local development]

By default, `wrangler dev` launches containers without the elevated permissions FUSE requires (`CAP_SYS_ADMIN`, access to `/dev/fuse`, and an unconfined AppArmor profile), so a FUSE mount inside the container will fail.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

By default, wrangler dev launches containers without the elevated permissions FUSE requires (CAP_SYS_ADMIN, access to /dev/fuse, and an unconfined AppArmor profile), so a FUSE mount inside the container will fail.

@rzazadebilal7

Copy link
Copy Markdown

Tək. Duz keçim . Neyləmək lazımdır

@github-actions

Copy link
Copy Markdown
Contributor

Hey there, we've marked this pull request as stale because there's no recent activity on it. This label helps us identify PRs that might need updates (or to be closed out by our team if no longer relevant).

@github-actions github-actions Bot added the stale label May 27, 2026
@Ben2W Ben2W force-pushed the fuse-enable-containers-privileged-mode branch from cbde058 to 8922aab Compare June 8, 2026 23:31
@Ben2W Ben2W requested a review from a team as a code owner June 8, 2026 23:31
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Review

✅ No style-guide issues found in commit 7b467d7.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.

Adds a callout to the R2 FUSE example, a new troubleshooting section
in the Containers local-dev page, and a changelog entry, all explaining
that FUSE in `wrangler dev` requires the new opt-in flag
(`dev.privileged_containers` / `--privileged-containers`).

Pairs with cloudflare/workerd#6596 and cloudflare/workers-sdk#13748.
Resolves cloudflare/workerd#5609.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

🐛 Bug Report — Runtime APIs: No privileged mode option for Containers local development

4 participants