Docker Agent overlay for a shell workload, with provider credentials and scoped egress.
7.7K
Docker Agent overlay for a shell workload, with provider credentials and scoped egress.
| Name | Required | Default | Description |
|---|---|---|---|
version | Required | — | Docker Agent release the image carries |
[email protected]| Type | Required | Description | |
|---|---|---|---|
com.docker.sandbox/network-policy@1 | Required | — | |
com.docker.sandbox/credential@1 | Optional | Anthropic API access | |
com.docker.sandbox/credential@1 | Optional | GitHub and Copilot access | |
com.docker.sandbox/credential@1 | Optional | Google AI API access | |
com.docker.sandbox/credential@1 | Optional | Mistral API access | |
com.docker.sandbox/credential@1 | Optional | Nebius API access | |
com.docker.sandbox/credential@1 | Optional | OpenAI API access | |
com.docker.sandbox/credential@1 | Optional | OpenRouter API access | |
com.docker.sandbox/credential@1 | Optional | xAI API access | |
com.docker.sandbox/agent-context@1 | Optional | — | |
com.docker.sandbox/agent-context@2 | Optional | — | |
com.docker.sandbox/acp@1 | Optional | — | |
sbx run <agent> --kit sbx/docker-agent-mixin:latestRun the following command to install sbx on your machine.
brew install docker/tap/sbxwinget install Docker.sbxThis v3 mixin Kit packages Docker Agent for Docker Sandboxes. It adds the agent, authentication configuration, and runtime integration to a compatible workload. The workload keeps its entrypoint.
This Kit is built on Docker Hardened Images.
sbx run sbx/shell:latest --kit sbx/docker-agent-mixin:latest /path/to/workspace
When the shell opens, run docker-agent run --yolo. This kit supplies an overlay, so it needs a workload such as
Shell.
The --yolo option allows tool execution without approval prompts. Omit it to use Docker Agent's native approval
behavior.
For a single prompt, run this command inside the shell. Do not combine --exec with --agent-picker.
docker-agent run --yolo --exec default "Summarize this repository"
This kit has no create-time kit arguments.
Bind the provider credentials your agent configuration uses on the host. Supported services are anthropic, github,
google, mistral, nebius, openai, openrouter, and xai. For example, run sbx secret set anthropic.
Credentials remain proxy-managed.
Automatic agent updates are disabled. Select a newer kit tag when you want a different Docker Agent release.
Use literal provider API keys. A Claude subscription login does not supply an Anthropic API key, and a ChatGPT subscription does not supply an OpenAI API key. Bind the matching API key on the host.
ACP support is included. Configure an ACP client to open a non-TTY stream to the sandbox.
sbx exec -i <sandbox> docker-agent serve acp default
The sandbox supplies the isolation for agent tool execution. Launch the kit through Docker Sandboxes and configure extra tool or MCP destinations in the runtime network policy as needed.
If a tool cannot reach a service, run sbx policy log on the host to identify blocked destinations.
sbx/docker-agent provides the complete agent workload.sbx/docker-agent-sessions provides host-backed conversation
state.For the Kit format and capability contracts, see the Sandbox Kit v3 specification.
For runtime setup, see the Docker Sandboxes documentation. For provenance, SBOM, VEX, and image verification, see the Docker Hardened Images documentation.
Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. Product names and logos do not imply sponsorship or endorsement.