deployment.md

Deployment

Railway

The repository includes railway.toml with:

• npm run start as the start command
• /health as the health check path

Recommended Initial Setup

• one replica
• REQUIRE_AUTH=true
• a strong PROXY_SESSION_SECRET
• DRIVER_PROXY_TRACE=false
• modest idle timeout and max session duration

Required Environment Variables

• PROXY_SESSION_SECRET

Common Optional Environment Variables

• PORT
• HOST
• DRIVER_CONSUMER_ME_URL
• DRIVER_SESSION_URL
• DEFAULT_DRIVER_COUNTRY
• DEFAULT_DRIVER_NODE_TYPE
• DEFAULT_DRIVER_CAPTCHA_SOLVER
• DEFAULT_SESSION_IDLE_TIMEOUT_MS
• DEFAULT_SESSION_MAX_DURATION_MS
• DRIVER_PROXY_VERBOSE
• DRIVER_PROXY_TRACE
• DRIVER_PROXY_TRACE_DIR

Operational Advice

• keep tracing off by default and enable it only for debugging
• monitor active session count and cleanup lag
• prefer colocating the proxy near the workloads that use it
• add Redis or another shared store before scaling to multiple stateless replicas