@cloudflare/sandbox
1.0.3 · 22 Oct 2026Apache-2.02.1M / weekRepositoryHomepagenpmAtom feed
Upgrading @cloudflare/sandbox From 0.11.0 to 0.12.0
1 release in betweenevery note read
Reading releases, release notes and advisories…
- 1
- change to make
- 0
- advisories fixed
- 1
- new
- 2
- fixes
Before you upgrade
Tick each one off as you go- Breaking0.12.0
Release by release
- Breaking
Remove the desktop client API and desktop Docker image variant. The
sandbox.desktopAPIs,DesktopClientexports, desktop-related types/errors, and-desktopcontainer image are no longer available. - New
Add
credentialProxyoption tomountBucketto keep real S3 credentials out of the container. When enabled, the Durable Object intercepts and signs outbound S3 requests — the container only sees dummy credentials. Supports S3-compatible endpoints, R2, and GCS HMAC signing, with optimized R2 mount defaults for reliable read and write performance. - Fixed
Fix bucket mounts when a Sandbox class defines a catch-all outbound handler by routing SDK-managed mount hosts through the SDK ContainerProxy.
- Fixed
Fix phantom
runningprocesses after a failedstartProcesscall. When the underlying session was unavailable or threw during startup, the process record was left in memory with statusrunningand would appear inlistProcesses()indefinitely. Failed startups are now correctly marked as terminalerrorrecords.
- Breaking
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.