--- title: Running commands in a Vercel Sandbox product: vercel url: /docs/vercel-sandbox/run-commands-in-sandbox type: how-to prerequisites: - /docs/vercel-sandbox related: - /docs/vercel-sandbox/cli-reference - /docs/vercel-sandbox summary: Create isolated sandbox environments to run builds, tests, and commands safely. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # Running commands in a Vercel Sandbox Use this guide to create isolated sandbox environments for running commands, builds, and tests. You'll create a sandbox, execute commands, copy files in and out, and save snapshots for reuse. > **💡 Note:** This guide requires the [Sandbox CLI](/docs/vercel-sandbox/cli-reference). > Install it with `npm i -g sandbox` and run `sandbox login` to > authenticate. ## Quick reference Use this block when you already know what you're doing and want the full command sequence. Use the steps below for context and checks. ```bash filename="terminal" # 1. Create a sandbox sandbox create --runtime node24 --timeout 1h --publish-port 3000 # 2. Copy project files into the sandbox sandbox cp ./my-app/. :/app # 3. Run commands inside the sandbox sandbox exec --workdir /app "npm install" sandbox exec --workdir /app "npm run build" sandbox exec --workdir /app --env NODE_ENV=test "npm test" # 4. Save the state as a snapshot for reuse sandbox snapshot --stop # 5. Create a new sandbox from the snapshot sandbox create --snapshot --timeout 30m # 6. Clean up sandbox stop ``` ## 1. Create a sandbox Create a new sandbox environment with the runtime and configuration you need: ```bash filename="terminal" sandbox create --runtime node24 --timeout 1h ``` This creates a Node.js 24 sandbox that auto-stops after one hour. The command outputs the sandbox ID. To make a port accessible via a public URL (useful for testing web applications): ```bash filename="terminal" sandbox create --runtime node24 --timeout 1h --publish-port 3000 ``` For Python workloads: ```bash filename="terminal" sandbox create --runtime python3.13 --timeout 1h ``` To create a sandbox and immediately connect to an interactive shell: ```bash filename="terminal" sandbox create --runtime node24 --timeout 1h --connect ``` ## 2. Copy files into the sandbox Copy your project files into the sandbox: ```bash filename="terminal" sandbox cp ./my-app/. :/app ``` You can also copy files out of the sandbox back to your local machine: ```bash filename="terminal" sandbox cp :/app/output/results.json ./results.json ``` ## 3. Run commands Execute commands inside the sandbox. Use `--workdir` to set the working directory: ```bash filename="terminal" sandbox exec --workdir /app "npm install" ``` ```bash filename="terminal" sandbox exec --workdir /app "npm run build" ``` To pass environment variables to the command: ```bash filename="terminal" sandbox exec --workdir /app --env NODE_ENV=test "npm test" ``` For commands that need elevated permissions: ```bash filename="terminal" sandbox exec --sudo "apt-get update && apt-get install -y jq" ``` ## 4. Connect to an interactive shell For exploratory work or debugging, connect to the sandbox interactively: ```bash filename="terminal" sandbox connect ``` This opens a shell session inside the sandbox. Exit the shell to disconnect. ## 5. Save a snapshot After setting up a sandbox with dependencies installed and configured, save it as a snapshot so you can recreate the same environment later: ```bash filename="terminal" sandbox snapshot --stop ``` Snapshotting always stops the sandbox automatically. The `--stop` flag confirms you acknowledge this behavior. To list your saved snapshots: ```bash filename="terminal" sandbox snapshots list ``` ## 6. Create a sandbox from a snapshot Recreate an environment from a saved snapshot: ```bash filename="terminal" sandbox create --snapshot --timeout 30m ``` This starts a new sandbox with all the files, dependencies, and configuration from the snapshot already in place. ## 7. Quick one-off commands For simple tasks where you don't need to manage the sandbox lifecycle, use `sandbox run`. This creates a sandbox, runs a command, and optionally cleans up: ```bash filename="terminal" sandbox run --runtime node24 --rm -- node -e 'console.log(process.version)' ``` The `--rm` flag automatically deletes the sandbox after the command finishes. ## 8. Configure network access Control what network resources the sandbox can reach: ```bash filename="terminal" sandbox create --runtime node24 --timeout 1h --network-policy deny-all --allowed-domain "*.npmjs.org" --allowed-domain "registry.npmjs.org" ``` To update the network policy of an existing sandbox: ```bash filename="terminal" sandbox config network-policy --network-policy deny-all --allowed-domain "api.example.com" ``` ## 9. Clean up Stop and remove a sandbox when you're done: ```bash filename="terminal" sandbox stop ``` To stop multiple sandboxes: ```bash filename="terminal" sandbox stop ``` To see all running sandboxes: ```bash filename="terminal" sandbox list ``` To include stopped sandboxes: ```bash filename="terminal" sandbox list --all ``` ## When to delete snapshots Remove snapshots you no longer need to keep your environment clean: ```bash filename="terminal" sandbox snapshots delete ``` ## Related - [Sandbox CLI reference](/docs/vercel-sandbox/cli-reference) - [Vercel Sandbox overview](/docs/vercel-sandbox) --- [View full sitemap](/docs/sitemap)