← Sandbox / sandbox

How-to guides

These guides show you how to solve specific problems and implement features with the Sandbox SDK. Each guide focuses on a particular task and provides practical, production-ready solutions.

2026 deprecation migration guide

Migrate away from deprecated Sandbox SDK features on the current stable package.

Run background processes

Start and manage long-running services and applications.

Backup and restore

Create point-in-time backups and restore sandbox directories.

Browser terminals

Connect browser-based terminals to sandbox shells using xterm.js or raw WebSockets.

Use code interpreter

Execute Python and JavaScript code with rich outputs.

Deploy a Sandbox application

Deploy a Sandbox Worker and keep the npm package and container image on the same release line.

Run Docker-in-Docker

Run Docker commands inside a sandbox container.

Execute commands

Run commands with streaming output, error handling, and shell access.

Expose services

Create preview URLs and expose ports for web services.

Watch filesystem changes

Monitor files and directories in real-time to build responsive development tools and automation workflows.

Work with Git

Clone repositories, manage branches, and automate Git operations.

Manage files

Read, write, organize, and synchronize files in the sandbox.

Mount buckets

Mount S3-compatible object storage as local filesystems for persistent data storage.

Handle outbound traffic

Intercept and handle outbound HTTP from sandboxes using Workers.

Configure preview URLs on a custom domain

Set up wildcard DNS, routes, and TLS so exposePort preview URLs work on your domain.

Stream output

Handle real-time output from commands and processes.

WebSocket connections

Connect to WebSocket servers running in sandboxes.

Connect to Workers bindings

Access KV, R2, Durable Objects, and other bindings from a sandbox.

Tutorials - Step-by-step learning paths
API reference - Complete method documentation

How-to guides

Related resources