English

Browser Configuration

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

Common Variables

Variable	Purpose
`HOMEPAGE`	Default page opened when the browser starts
`BROWSER_LANG`	Browser language and `Accept-Language`
`CHROME_UI_LANG`	Chromium UI language
`BROWSER_USER_AGENT`	Custom user agent string
`BROWSER_EXTRA_ARGS`	Additional Chromium launch arguments

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

-e HOMEPAGE=https://example.com

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

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.

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

Example:

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