From 5ebd5288b04b07b3b51bca066bf5814bb0e610e1 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Thu, 27 Aug 2026 09:43:23 +0000 Subject: [PATCH 1/2] docs: document sandbox Docker volume sizing Sandbox Docker data disks now default to 10 GB and support a configurable default. Document the daemon setting, per-sandbox override, minimum size, and creation-only behavior. Co-Authored-By: Claude --- .../ai/sandboxes/customize/templates.md | 18 +++++++++++---- .../manuals/ai/sandboxes/troubleshooting.md | 23 +++++++++++++++---- 2 files changed, 33 insertions(+), 8 deletions(-) diff --git a/content/manuals/ai/sandboxes/customize/templates.md b/content/manuals/ai/sandboxes/customize/templates.md index 72bcade5d94..fe3718db9b0 100644 --- a/content/manuals/ai/sandboxes/customize/templates.md +++ b/content/manuals/ai/sandboxes/customize/templates.md @@ -61,16 +61,26 @@ default. The agent containers created from the `-docker` templates run in privileged mode inside the microVM (not on your host), with a dedicated block volume at `/var/lib/docker`, and `dockerd` starts automatically inside the sandbox. The -block volume defaults to 50 GB and uses a sparse file, so it only consumes +block volume defaults to 10 GB and uses a sparse file, so it only consumes disk space as Docker writes to it. -To override the volume size, set the `DOCKER_SANDBOXES_DOCKER_SIZE` -environment variable to a size string before starting the sandbox: +To change the default for sandboxes you create later, set +`sandbox.disk.dockerVolume`: ```console -$ DOCKER_SANDBOXES_DOCKER_SIZE=10g sbx run claude +$ sbx settings set sandbox.disk.dockerVolume 20g ``` +To override the default for one sandbox, set +`DOCKER_SANDBOXES_DOCKER_SIZE` when you create it: + +```console +$ DOCKER_SANDBOXES_DOCKER_SIZE=20g sbx run claude +``` + +The volume size must be at least 512 MiB. Changing the setting or using the +environment variable doesn't resize existing volumes. + Use the non-Docker variant if you don't need to build or run containers inside the sandbox and want a lighter, non-privileged environment. Specify it explicitly with `--template`: diff --git a/content/manuals/ai/sandboxes/troubleshooting.md b/content/manuals/ai/sandboxes/troubleshooting.md index fc518e40ebf..8c6bb13f0f4 100644 --- a/content/manuals/ai/sandboxes/troubleshooting.md +++ b/content/manuals/ai/sandboxes/troubleshooting.md @@ -204,15 +204,30 @@ the egress path in the **PROXY** column: ## Sandbox runs out of disk space -The sandbox root (`/`) filesystem defaults to 20 GB. To increase it, set `DOCKER_SANDBOXES_ROOT_SIZE` -before creating the sandbox: +The sandbox root (`/`) filesystem defaults to 20 GB. To increase it, set +`DOCKER_SANDBOXES_ROOT_SIZE` before creating the sandbox: ```console $ DOCKER_SANDBOXES_ROOT_SIZE=40g sbx run claude ``` -`DOCKER_SANDBOXES_ROOT_SIZE` controls the root filesystem size. `DOCKER_SANDBOXES_DOCKER_SIZE` -controls the Docker data disk (`/var/lib/docker`) size. The two are independent — set both if needed. +`DOCKER_SANDBOXES_ROOT_SIZE` controls the root filesystem size. The Docker data +disk at `/var/lib/docker` is independent and defaults to 10 GB. To change its +default for sandboxes you create later, run: + +```console +$ sbx settings set sandbox.disk.dockerVolume 20g +``` + +To override the Docker data disk size for one sandbox, set +`DOCKER_SANDBOXES_DOCKER_SIZE` when you create it: + +```console +$ DOCKER_SANDBOXES_DOCKER_SIZE=20g sbx run claude +``` + +The Docker data disk must be at least 512 MiB. Neither method resizes existing +volumes. For a [clone-mode sandbox](usage.md#clone-mode), set `DOCKER_SANDBOXES_CLONED_WORKSPACE_SIZE` before creating the sandbox to From dc724d83a6e134a0333ef43f48d1998454db83f7 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Thu, 27 Aug 2026 10:37:39 +0000 Subject: [PATCH 2/2] docs: use environment variable for Docker volume size --- .../manuals/ai/sandboxes/customize/templates.md | 13 +++---------- content/manuals/ai/sandboxes/troubleshooting.md | 16 +++++----------- 2 files changed, 8 insertions(+), 21 deletions(-) diff --git a/content/manuals/ai/sandboxes/customize/templates.md b/content/manuals/ai/sandboxes/customize/templates.md index fe3718db9b0..3006bc19b91 100644 --- a/content/manuals/ai/sandboxes/customize/templates.md +++ b/content/manuals/ai/sandboxes/customize/templates.md @@ -64,22 +64,15 @@ mode inside the microVM (not on your host), with a dedicated block volume at block volume defaults to 10 GB and uses a sparse file, so it only consumes disk space as Docker writes to it. -To change the default for sandboxes you create later, set -`sandbox.disk.dockerVolume`: - -```console -$ sbx settings set sandbox.disk.dockerVolume 20g -``` - -To override the default for one sandbox, set +To change the volume size for a sandbox, set `DOCKER_SANDBOXES_DOCKER_SIZE` when you create it: ```console $ DOCKER_SANDBOXES_DOCKER_SIZE=20g sbx run claude ``` -The volume size must be at least 512 MiB. Changing the setting or using the -environment variable doesn't resize existing volumes. +The volume size must be at least 512 MiB. The environment variable doesn't +resize existing volumes. Use the non-Docker variant if you don't need to build or run containers inside the sandbox and want a lighter, non-privileged environment. Specify diff --git a/content/manuals/ai/sandboxes/troubleshooting.md b/content/manuals/ai/sandboxes/troubleshooting.md index 8c6bb13f0f4..b3dc1f16140 100644 --- a/content/manuals/ai/sandboxes/troubleshooting.md +++ b/content/manuals/ai/sandboxes/troubleshooting.md @@ -212,22 +212,16 @@ $ DOCKER_SANDBOXES_ROOT_SIZE=40g sbx run claude ``` `DOCKER_SANDBOXES_ROOT_SIZE` controls the root filesystem size. The Docker data -disk at `/var/lib/docker` is independent and defaults to 10 GB. To change its -default for sandboxes you create later, run: - -```console -$ sbx settings set sandbox.disk.dockerVolume 20g -``` - -To override the Docker data disk size for one sandbox, set -`DOCKER_SANDBOXES_DOCKER_SIZE` when you create it: +disk at `/var/lib/docker` is independent and defaults to 10 GB. To change the +Docker data disk size for a sandbox, set `DOCKER_SANDBOXES_DOCKER_SIZE` when you +create it: ```console $ DOCKER_SANDBOXES_DOCKER_SIZE=20g sbx run claude ``` -The Docker data disk must be at least 512 MiB. Neither method resizes existing -volumes. +The Docker data disk must be at least 512 MiB. The environment variable doesn't +resize existing volumes. For a [clone-mode sandbox](usage.md#clone-mode), set `DOCKER_SANDBOXES_CLONED_WORKSPACE_SIZE` before creating the sandbox to