Share feedback
Answers are generated based on the documentation.

docker sandbox ls

DescriptionList VMs
Usagedocker sandbox ls [OPTIONS]
Aliases
docker sandbox list

Description

Warning

The Docker Desktop-integrated docker sandbox commands are deprecated and replaced by the standalone sbx CLI. This deprecation applies only to the Docker Desktop integration, not to Docker Sandboxes.

List all VMs managed by sandboxd with their sandboxes

Options

OptionDefaultDescription
--jsonOutput in JSON format
-q, --quietOnly display VM names

Examples

List all VMs

$ docker sandbox ls
VM ID         NAME       STATUS    WORKSPACE                    SOCKET PATH                           SANDBOXES    AGENTS
abc123def     claude-vm  running   /home/user/my-project        /Users/.../docker-1764682554072.sock  2           claude
def456ghi     gemini-vm  stopped   /home/user/ml-projects

Show only VM names (--quiet)

--quiet

Output only VM names:

$ docker sandbox ls --quiet
claude-vm
gemini-vm

JSON output (--json)

--json

Output detailed VM information in JSON format:

$ docker sandbox ls --json
{
  "vms": [
    {
      "name": "claude-vm",
      "agent": "claude",
      "status": "running",
      "socket_path": "/Users/user/.docker/sandboxes/vm/claude-vm/docker-1234567890.sock",
      "sandbox_count": 2,
      "workspaces": [
        "/home/user/my-project",
        "/home/user/another-project"
      ]
    },
    {
      "name": "gemini-vm",
      "agent": "gemini",
      "status": "stopped",
      "sandbox_count": 0
    }
  ]
}