Environment Variables

Configuration options for Tollbooth services.

Backend

Variable	Default	Description
`REST_PORT`	3000	REST API port
`PROXY_WS_PORT`	3001	WebSocket for proxy connection
`FRONTEND_WS_PORT`	3002	WebSocket for frontend
`WS_MAX_PAYLOAD`	209715200	Max WebSocket payload (bytes)

Variable	Default	Description
`REFUSAL_MODEL_ID`	`Xenova/nli-deberta-v3-small`	Zero-shot classification model
`MODEL_CACHE_DIR`	`/app/models`	ML model cache directory

Available models:

See Data Persistence for details.

Variable	Default	Description
`TOLLBOOTH_DATA_PATH`	`/data`	Base path for persistent data
`TOLLBOOTH_PERSIST_TRAFFIC`	`true`	Persist traffic flows
`TOLLBOOTH_PERSIST_CONVERSATIONS`	`true`	Persist conversations
`TOLLBOOTH_PERSIST_REPLAY`	`true`	Persist replay variants
`TOLLBOOTH_PERSIST_RULES`	`true`	Persist rules
`TOLLBOOTH_PERSIST_CONFIG`	`true`	Persist config files
`TOLLBOOTH_PERSIST_STORE`	`true`	Persist datastore entries

Variable	Default	Description
`VITE_BACKEND_URL`	`http://localhost:2000`	Backend REST API URL
`VITE_WS_URL`	`ws://localhost:2002`	Backend WebSocket URL

Variable	Default	Description
`BACKEND_WS_URL`	`ws://backend:3001`	Backend WebSocket URL
`MAX_BODY_SIZE`	1048576	Max body size to forward (bytes)

Bodies larger than MAX_BODY_SIZE are truncated when sent to the backend. LLM API bodies are always included in full regardless of this setting.

Variable	Description
`ANTHROPIC_API_KEY`	Passed from host if set
`OPENAI_API_KEY`	Passed from host if set