Sign inSign up
codex logo

sbx/codex

Verified Publisher
Cloud

By Docker, Inc

•Updated about 2 hours ago

OpenAI Codex CLI on Docker Hardened Images for Docker Sandboxes

Sandbox Kit
2

100K+

sbx/codex repository overview

Digest

sha256:7e3507e8854a…

Size

361.4 MB

Schema

v3

Pushed

about 2 hours ago

Specificationspec.yaml

WORKLOAD

OpenAI's Codex CLI on Docker Hardened Images


Arguments
NameRequiredDefaultDescription
modelOptional

Codex model to use (config.toml `model`); empty keeps the CLI default

reasoningEffortOptional

Reasoning effort (config.toml `model_reasoning_effort`); empty keeps the CLI default

versionRequired—

Codex CLI release the image carries


Provides[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/ca-certificates@20250419, deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/iputils-ping@20240905, deb/[email protected], deb/less@668, deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected], deb/[email protected]

CapabilitiesExpand a row to see its full configuration. See the full spec for the complete descriptor.
TypeRequiredDescription
com.docker.sandbox/sbx@1Required—
com.docker.sandbox/network-policy@1Required—
com.docker.sandbox/credential@1OptionalOpenAI API access (API key or ChatGPT OAuth)
com.docker.sandbox/lifecycle@1Required—
com.docker.sandbox/agent-sessions@1Optional—
com.docker.sandbox/agent-interactive-sessions@1Optional—
com.docker.sandbox/agent-skills@1Optional—
com.docker.sandbox/agent-context@1Optional—
com.docker.sandbox/agent-context@2Optional—

Try this kit

Run this in a sandbox (opens in a new tab)
sbx run sbx/codex:latest

Make sure you have docker sbx installed

Run the following command to install sbx on your machine.

macOS
brew install docker/tap/sbx
Windows
winget install Docker.sbx
Learn more about docker sbx⁠

⁠Codex for Docker Sandboxes

This v3 workload Kit packages Codex⁠ for Docker Sandboxes. It includes the agent and a development environment. Start the workload to use Codex in an isolated workspace.

This Kit is built on Docker Hardened Images.

⁠Run

sbx run sbx/codex:latest /path/to/workspace

⁠Kit arguments

Set these arguments when creating the sandbox with --kit-arg <name>=<value>. Repeat the flag for multiple arguments. Use --kit-arg <kit>.<name>=<value> to target one kit in a composition, as in the example below.

ArgumentDefaultDescriptionAccepted values
model""Codex model to use (config.toml model); empty keeps the CLI defaultLetters, digits, ., _, and -.
reasoningEffort""Reasoning effort (config.toml model_reasoning_effort); empty keeps the CLI defaultEmpty, none, minimal, low, medium, high, xhigh, max, ultra, or persistent.

An empty value keeps the agent default. The model must be available to your provider account, and the selected model must support the requested effort or thinking level. These are kit configuration inputs, separate from agent command-line arguments passed after --.

sbx run sbx/codex:latest \
  --kit-arg codex.model=gpt-5 --kit-arg codex.reasoningEffort=high \
  /path/to/workspace

⁠Authentication and configuration

Bind an OpenAI API key on the host with sbx secret set openai. For a ChatGPT login, run sbx secret set openai --oauth on the host. You can also sign in from Codex inside the sandbox. Host-bound credentials remain proxy-managed.

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.

⁠Source and security

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⁠.

Codex and OpenAI are trademarks of OpenAI, L.L.C. Product names and logos do not imply sponsorship or endorsement.