Environment Variables
All environment variables for @ulpi/browse configuration.
| Variable | Default | Description |
|---|
BROWSE_PORT | Auto (9400-10400) | Fixed server port |
BROWSE_PORT_START | 9400 | Start of port scan range |
BROWSE_INSTANCE | Auto (PPID) | Instance ID — suffix for state file, allows multiple servers per project |
BROWSE_IDLE_TIMEOUT | 1800000 (30min) | Session auto-close timeout (ms) |
BROWSE_TIMEOUT | — | Override all command and action timeouts (ms) |
BROWSE_START_TIMEOUT | 8000 | Max wait time for server startup (ms) |
BROWSE_SERVER_SCRIPT | Auto-detected | Override path to server script (for development) |
BROWSE_LOCAL_DIR | .browse/ | State, log, and screenshot directory |
BROWSE_HEADED | "0" | Set to "1" to run browser in headed (visible) mode |
BROWSE_MAX_OUTPUT | — | Truncate output to N characters |
| Variable | Default | Description |
|---|
BROWSE_SESSION | "default" | Default session ID |
BROWSE_PROFILE | — | Default persistent browser profile name |
BROWSE_JSON | "0" | Set to "1" for JSON output mode |
BROWSE_CONTENT_BOUNDARIES | "0" | Set to "1" for nonce-delimited output |
| Variable | Default | Description |
|---|
BROWSE_ALLOWED_DOMAINS | — | Comma-separated domain allowlist |
BROWSE_ENCRYPTION_KEY | — | AES-256-GCM key for credential vault |
BROWSE_POLICY | browse-policy.json | Path to action policy file |
BROWSE_CONFIRM_ACTIONS | — | Comma-separated commands requiring user confirmation |
BROWSE_AUTH_PASSWORD | — | Supply password for auth save via env var |
| Variable | Default | Description |
|---|
BROWSE_PROXY | — | Proxy server URL |
BROWSE_PROXY_BYPASS | — | Comma-separated domains to bypass proxy |
BROWSE_CDP_URL | — | Direct CDP WebSocket URL for remote Chrome |
BROWSE_DEBUG_PORT | — | Port for DevTools debugging |
| Variable | Default | Description |
|---|
BROWSE_RUNTIME | "playwright" | Browser runtime: playwright, rebrowser (stealth), lightpanda, chrome (system Chrome) |
BROWSE_CHROME | "0" | Set to "1" to use system Chrome (shortcut for --runtime chrome --headed) |
BROWSE_CHROME_PATH | Auto-detected | Override Chrome executable path |
BROWSE_PROVIDER | — | Cloud browser provider: browserbase, browserless |
BROWSERLESS_URL | wss://production-sfo.browserless.io | Browserless WebSocket endpoint |
BROWSERBASE_PROJECT_ID | — | Browserbase project ID (required for browserbase provider) |
BROWSE_MCP | "0" | Set to "1" to start in MCP server mode |