• English

      • Environment Configuration

      AIO Sandbox uses environment variables to configure services at container startup. When values are provided through Docker, Compose, or SDK configuration, pass them as strings.

      Workspace

      VariableDefaultPurpose
      WORKSPACE/home/gemDefault working directory for shell, code execution, Jupyter, and code-server
      USERgemRuntime user inside the container

      Network And Proxy

      VariableDefaultPurpose
      PROXY_SERVERemptyUpstream HTTP/HTTPS proxy for browser and network traffic
      PROXY_EXCLUDEemptyHosts that should bypass the upstream proxy
      PROXY_INCLUDEemptyHosts that should use the upstream proxy in allow-list mode
      PROXY_MAPemptyStatic host mapping rules for advanced proxy scenarios

      Browser

      VariableDefaultPurpose
      HOMEPAGEemptyPage opened when Chromium starts
      BROWSER_LANGen-USBrowser language and Accept-Language preference
      CHROME_UI_LANGemptyChromium UI language
      BROWSER_USER_AGENTdefault Chromium UACustom user agent
      BROWSER_EXTRA_ARGSemptyAdditional Chromium launch flags
      BROWSER_ALLOW_FILE_SELECTION_DIALOGSemptyControls whether web pages can open file picker dialogs; set to false to block file picker dialogs

      Services

      VariableDefaultPurpose
      CODE_SERVER_PORT8200Internal code-server port
      DISABLE_CODE_SERVERfalseDisable code-server when set to a truthy value
      DISABLE_JUPYTERfalseDisable JupyterLab when set to a truthy value
      SANDBOX_SRV_PORT8080Main API service port inside the container

      Security

      VariableDefaultPurpose
      JWT_PUBLIC_KEYemptyEnables Bearer token verification for API and web routes
      AUTH_TOKENemptyShared token for simple deployments, when supported by the running image

      Lifecycle Hooks

      VariableTiming
      RUN_HOOK_INITEarliest startup hook
      RUN_HOOK_PRE_SERVICESBefore managed services start
      RUN_HOOK_POST_READYAfter services are ready

      See AIO Hooks for examples.