Guide
API
Blog
Version
Guide
API
Blog

Browser Configuration

AIO Sandbox runs Chromium inside the container. You can configure language, homepage, user agent, and launch flags through environment variables.

Common Variables

VariablePurpose
HOMEPAGEDefault page opened when the browser starts
BROWSER_LANGBrowser language and Accept-Language
CHROME_UI_LANGChromium UI language
BROWSER_USER_AGENTCustom user agent string
BROWSER_EXTRA_ARGSAdditional Chromium launch arguments
BROWSER_ALLOW_FILE_SELECTION_DIALOGSControls whether web pages can open file picker dialogs

Language

docker run --security-opt seccomp=unconfined --rm -it \
  -p 127.0.0.1:8080:8080 \
  -e BROWSER_LANG=en-US \
  ghcr.io/agent-infra/sandbox:latest

Homepage

-e HOMEPAGE=https://example.com

User Agent

-e BROWSER_USER_AGENT="Mozilla/5.0 ..."

Extra Arguments

Use BROWSER_EXTRA_ARGS for advanced Chromium flags:

-e BROWSER_EXTRA_ARGS="--disable-dev-shm-usage"

Be conservative with launch flags. Removing default security or process flags can make automation less stable.

File Selection Dialog Policy

AIO Sandbox supports BROWSER_ALLOW_FILE_SELECTION_DIALOGS to control whether web pages can open file picker dialogs. Set it to false to prevent upload controls from opening the system file picker:

docker run --security-opt seccomp=unconfined --rm -it \
  -p 127.0.0.1:8080:8080 \
  -e BROWSER_ALLOW_FILE_SELECTION_DIALOGS=false \
  ghcr.io/agent-infra/sandbox:latest

When the variable is unset or empty, the browser keeps its default behavior.

Runtime Configuration

Some browser settings can also be inspected or changed through API endpoints such as:

  • POST /v1/browser/config
  • POST /v1/browser/restart
  • GET /v1/browser/info

Example:

curl -X POST http://127.0.0.1:8080/v1/browser/config \
  -H 'Content-Type: application/json' \
  -d '{"resolution":{"width":1280,"height":720}}'