Skip to main content

Environment Variables

Policy environment variables are passed into the per-user Open Terminal container. They are raw strings, not shell commands.

Use raw values in the Open WebUI admin panel:

Desired value inside the containerEnter this in the admin panel
sk-proj-abcsk-proj-abc
*.pypi.org,github.com*.pypi.org,github.com
hello worldhello world
"hello world" including quote characters"hello world"

Do not add ' or " around a value unless the quote characters are part of the value you want the container to see.

Forwarding Behavior

Use policy env for values that should appear inside per-user Open Terminal containers. Orchestrator process env vars configure the orchestrator itself.

The orchestrator refuses to forward OPEN_TERMINAL_API_KEY from policy env. It generates a private API key per terminal instance and uses that key to proxy requests safely.

warning

Policy env vars are visible to the user inside their terminal. Do not put secrets in a policy unless users are allowed to see and use them.

Common Open Terminal Env Vars

VariablePurpose
OPEN_TERMINAL_ALLOWED_DOMAINSRestrict outbound network access, for example *.pypi.org,github.com
OPEN_TERMINAL_EXECUTE_TIMEOUTDefault command wait timeout in seconds
OPEN_TERMINAL_EXECUTE_DESCRIPTIONExtra tool-description text shown to the model
OPEN_TERMINAL_SYSTEM_PROMPTCustom system prompt template
OPEN_TERMINAL_INFOExtra environment information appended to the generated prompt
OPEN_TERMINAL_FILE_BROWSER_ROOTFile-browser visual root. Use home, an explicit path such as /workspace, or filesystem to opt out
OPEN_TERMINAL_PACKAGESSpace-separated apt packages installed at container startup
OPEN_TERMINAL_PIP_PACKAGESSpace-separated Python packages installed at container startup
OPEN_TERMINAL_NPM_PACKAGESSpace-separated npm packages installed globally at container startup

Automatically Injected Resource Vars

These are set automatically by the orchestrator from the policy's cpu_limit and memory_limit, so a system prompt or tool can read the container's resource budget. They are not user-configured.

VariablePurpose
OPEN_TERMINAL_CPU_LIMITCPU limit from the policy cpu_limit
OPEN_TERMINAL_CPU_COUNTCPU count derived from the policy cpu_limit
OPEN_TERMINAL_MEMORY_LIMITMemory limit from the policy memory_limit
OPEN_TERMINAL_MEMORY_BYTESMemory limit in bytes derived from the policy memory_limit
This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.