Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions content/manuals/agentic-platform/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,8 @@ aliases:
## What can I run in Docker Agentic Platform?

Docker Agentic Platform provides predefined sandbox types for Claude Code,
Codex, OpenCode, Copilot, and Gemini CLI. Each runs in an isolated, Docker-hosted
sandbox with a live terminal.
Codex, OpenCode, Copilot, Gemini CLI, and Shell. Each type runs in an isolated,
Docker-hosted sandbox with a live terminal.

## How does Docker Agentic Platform differ from Docker Sandboxes?

Expand Down
23 changes: 12 additions & 11 deletions content/manuals/agentic-platform/get-started.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Get started with Docker Agentic Platform
linkTitle: Get started
description: Choose an agent environment and start a Docker Agentic Platform sandbox.
description: Choose an environment and start a Docker Agentic Platform sandbox.
keywords: docker agentic platform, get started, agents, sandbox, live terminal
weight: 10
aliases:
Expand All @@ -11,25 +11,26 @@ aliases:
---

The Docker Agentic Platform launcher collects the configuration needed to start
an agent in an isolated sandbox.
an isolated sandbox.

## Before you begin

You need a Docker account, access to Docker Agentic Platform, and an API key for
the model provider you want to use. You can add the key under **Secrets** before
creating the sandbox or provide it in the launcher when prompted.
You need a Docker account and access to Docker Agentic Platform. The launcher
prompts for a model provider API key when needed. You can add the key under
**Secrets** before creating the sandbox or provide it in the launcher when
prompted.

The available sandbox types are Claude Code, Codex, OpenCode, Copilot, and
Gemini CLI. The supported model provider credentials are Anthropic, OpenAI,
The available sandbox types are Claude Code, Codex, OpenCode, Copilot, Gemini
CLI, and Shell. The supported model provider credentials are Anthropic, OpenAI,
GitHub Copilot, and Google.

## Start a sandbox

1. Open [Docker Agentic Platform](https://agentic-platform.docker.com/) and
select **New**.
2. Choose a sandbox type and select or add its required model credential.
Copilot uses `GITHUB_TOKEN`; add the same GitHub secret to any other sandbox
type that needs private repository access.
2. Choose a sandbox type and add any requested model credential. Copilot uses
`GITHUB_TOKEN`; add the same GitHub secret to any other sandbox type that
needs private repository access.
3. Configure the sandbox. The initial settings are **open access**, **no tools
added**, and **medium compute**.
4. Choose whether Docker stops or deletes the sandbox when its timer expires,
Expand All @@ -40,7 +41,7 @@ You cannot change the sandbox's authentication, tools, access policy, or compute
size after it starts. Docker creates the sandbox, marks it as running, and opens
its terminal.

Use the terminal to interact with the selected agent or tool.
Use the terminal to interact with the sandbox.

Return to **Sandboxes** to find the running sandbox and reopen its terminal.

Expand Down
29 changes: 18 additions & 11 deletions content/manuals/agentic-platform/sandboxes.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,29 @@
---
title: Sandboxes
description: Create and manage hosted agent environments in Docker Agentic Platform.
description: Create and manage hosted environments in Docker Agentic Platform.
keywords: docker agentic platform, sandboxes, agents, cloud runtime, terminal, compute
weight: 20
aliases:
- /agentic-platform/concepts/sandboxes/
- /agentic-platform/guides/manage-sandboxes/
---

A sandbox is an isolated runtime for an agent or tool. Docker hosts and meters
the sandbox on managed cloud infrastructure and provides a live terminal for
A sandbox is an isolated runtime on Docker-managed cloud infrastructure.
Docker hosts and meters the sandbox and provides a live terminal for
interacting with it.

Docker Agentic Platform provides predefined sandbox types for Claude Code,
Codex, OpenCode, Copilot, and Gemini CLI. Each sandbox has its own compute,
filesystem, network access, and terminal. A sandbox continues running
independently of your connection to the Console until it is paused, stopped by
its lifecycle timer, or deleted.
Codex, OpenCode, Copilot, Gemini CLI, and Shell. All sandbox types run Ubuntu on
x86-64 compute with Docker pre-installed. Each sandbox has its own compute,
filesystem, network access, and terminal. The compute size that you select
determines its CPU and memory resources.

The Shell type opens a Bash shell without a pre-installed agent. It uses the
same agent-less environment as [`sbx run shell`](/manuals/ai/sandboxes/agents/shell.md)
and is useful for working manually or installing your own agent.

A sandbox continues running independently of your connection to the Console
until it is paused, stopped by its lifecycle timer, or deleted.

## Source code and files

Expand All @@ -40,7 +47,7 @@ without a GitHub credential, but writing to them still requires authentication.
## Open a sandbox

After you select **Run**, Docker creates the sandbox and opens its detail page.
Use the terminal to interact with the selected agent or tool.
Use the terminal to interact with the sandbox.

Open **Sandboxes** to review each sandbox's name, type, status, hourly rate,
expiration, and age. Select a sandbox to reopen its detail page and terminal.
Expand All @@ -66,11 +73,11 @@ account, usage, and payment information, see [Docker Billing](/billing/).

## Check sandbox configuration

If the agent cannot reach a service or use a tool, check the configuration that
applies to the request:
If the sandbox cannot reach a service or use a tool, check the configuration
that applies to the request:

- Confirm that the network policies permit the destination.
- If the agent needs an MCP tool, confirm that its server is connected and
- If the sandbox needs an MCP tool, confirm that its server is connected and
authorized.
- If the destination requires authentication, confirm that the required
service credential is configured under **Secrets**.