Environment Variables
Environment variables override config file values and are useful for CI, scripting, and development.
Authentication
| Variable | Description |
|---|---|
| BOTSTER_TOKEN | API token (bypasses keyring) |
| BOTSTER_MCP_TOKEN | MCP token for plugins |
| BOTSTER_NO_BROWSER | Skip browser launch during device auth flow |
Server
| Variable | Description |
|---|---|
| BOTSTER_SERVER_URL | Override server URL (default: https://trybotster.com) |
Paths
| Variable | Description |
|---|---|
| BOTSTER_CONFIG_DIR | Config directory (default: platform-specific) |
| BOTSTER_LOG_FILE | Log file path |
| BOTSTER_WORKTREE_BASE | Worktree directory (default: ~/botster-sessions) |
Behavior
| Variable | Description |
|---|---|
| BOTSTER_POLL_INTERVAL | Server poll interval in seconds (default: 5) |
| BOTSTER_MAX_SESSIONS | Max concurrent agents (default: 20) |
| BOTSTER_AGENT_TIMEOUT | Agent idle timeout in seconds (default: 3600) |
| BOTSTER_HUB_ID | Hub identifier override (default: git repo name) |
Lua
| Variable | Description |
|---|---|
| BOTSTER_LUA_PATH | Override Lua scripts path (default: ~/.botster/lua) |
| BOTSTER_LUA_STRICT | If "1", Lua errors panic instead of logging |