Customizing sandboxes
Table of contents
Docker Sandboxes offers two ways to customize a sandbox beyond the built-in defaults:
- Templates — reusable sandbox images with tools, packages, and configuration baked in. Extend a base image with a Dockerfile, or save a running sandbox as a template.
- Kits — declarative YAML artifacts that extend an agent with tools, credentials, network rules, and files at runtime, or define a new agent from scratch.
When to use which
| Goal | Option |
|---|---|
| Pre-install tools and packages into a reusable base image | Template |
| Capture a configured running sandbox for reuse | Saved template |
| Add a tool, credential, or config to agent runs via YAML | Kit (mixin) |
| Define a new agent from scratch | Kit (agent) |
Templates and kits can be used together. A template bakes heavy tools into the image for fast sandbox startup; a kit layered on top adds per-run credentials, config, or extra capabilities.
Tutorials
- Build your own agent kit — step-by-step walkthrough for packaging Amp as an agent kit.