Configuration (11)

Last updated Sep 30, 2026 Note

This page documents Sandbox SDK 0.x for existing applications. For new applications, refer to Sandboxes. To move an existing application to @cloudflare/sandbox 1.0, refer to Migrate from Sandbox SDK 0.x.

Configure your Sandbox SDK deployment with Wrangler, customize container images, and manage environment variables.

Wrangler configuration

Configure Durable Objects bindings, container images, and Worker settings in wrangler.jsonc.

Dockerfile reference

Customize the sandbox container image with your own packages, tools, and configurations.

Environment variables

Pass configuration and secrets to your sandboxes using environment variables.

Transport modes

Configure HTTP or RPC transport to optimize communication and avoid subrequest limits.

Sandbox options

Configure sandbox behavior with options like keepAlive for long-running processes.

Was this helpful?

YesNo

On this page

Configuration (11) - 图1Docs

{"@context":"https://schema.org","@type":"WebPage","@id":"https://developers.cloudflare.com/sandbox/sdk/configuration/#page","headline":"Configuration","description":"Configure Sandbox SDK 0.x deployments with Wrangler, Dockerfiles, environment variables, and transport modes.","url":"https://developers.cloudflare.com/sandbox/sdk/configuration/","inLanguage":"en","image":"https://developers.cloudflare.com/sandbox/sdk/configuration/og.png?v=e954ba36141524b7","dateModified":"2026-09-30","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Customize the Sandbox SDK 0.x container image with packages, tools, and configurations. title: Dockerfile reference image: https://developers.cloudflare.com/sandbox/sdk/configuration/dockerfile/og.png?v=b9a687a555db7761

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/sandbox/llms.txt
Use this file to discover all available pages before exploring further.