Sandbox customization

To create a sandbox template, you provide an agentbox.Dockerfile. AgentBox takes this Dockerfile, builds it into a sandbox template, and returns a template ID.

You can then use this template ID with the SDK or CLI to create new sandboxes based on your custom configuration.

Tip: The agentbox.Dockerfile follows the standard Dockerfile syntax, allowing you to fully customize your sandbox environment — including dependencies, configurations, and startup commands.

The Steps to create custom sandbox

Use this option if you know beforehand what packages you need in the sandbox.

1. Install AgentBox CLI

2. Authentication with AgentBox CLI

3. Initialize sandbox template

agentbox template init

4. Customize agentbox.Dockerfile

# AgentBox template, you can use most Debian-based base images
FROM ubuntu:24.04

# Install customize dependencies

5. Build your sandbox template

Run the following command to build the sandbox template.

# --platform [ linux_x86 | android ]
agentbox template build --platform linux_x86 -p YOUR_WORKPATH

Note: Building the Template can take a few minutes. Once finished, you will see a ID, for example:

✅ Building sandbox template YOUR_TEMPLATE_ID finished.

6. Start your sandbox

agentbox sandbox sp ${YOUR_TEMPLATE_ID}