OpenHVX Docs

Each service has its own .env file:

Service	File	Description
Auth Service	`.env.auth`	JWT and Mongo configuration
API Gateway	`.env.gateway`	HTTP gateway + CORS
Controller	`.env.controller`	Core logic, RabbitMQ, MongoDB
WS Broker	`.env.ws`	WebSocket broker configuration

Variable	Example	Description
`PORT`	`8081`	HTTP port exposed by the broker
`JWT_AGENT_SECRET`	`supersecret_agent`	Token for agent auth
`JWT_BROWSER_SECRET`	`supersecret_browser`	Token for browser sessions

Variable	Example	Description
`PORT`	`8080`	API Gateway port
`AUTH_URL`	`http://auth:4000`	Internal service URL for Auth
`CONTROLLER_URL`	`http://controller:3000`	Internal service URL for Controller
`CORS_ORIGIN`	`http://localhost:5173,http://127.0.0.1:5173`	Allowed origins for web UI
`BROKER_URL`	`http://ws-broker:8081`	Internal URL to WebSocket broker

Variable	Example	Description
`PORT`	`3000`	HTTP port for Controller
`CORS_ORIGIN`	`*`	Allowed origins
`LOG_LEVEL`	`info`	Logging verbosity
`MONGO_URL`	`mongodb://mongo:27017/hvwm`	Mongo connection string
`MONGO_DB`	`openhvx`	Database name
`RMQ_URL`	`amqp://guest:guest@rabbitmq:5672/`	RabbitMQ connection
`JOBS_EXCHANGE`	`jobs`	Exchange for async jobs
`TELEMETRY_EXCHANGE`	`agent.telemetry`	Exchange for telemetry
`RESULTS_EXCHANGE`	`results`	Exchange for agent task results
`HEARTBEATS_QUEUE`	`agent.heartbeats`	Queue for agent heartbeats
`HEARTBEATS_TTL_MS`	`120000`	Heartbeat timeout (ms)
`INVENTORIES_QUEUE`	`agent.inventories`	Queue for agent inventories
`RESULTS_QUEUE`	`results.controller`	Queue consumed by controller
`RESULTS_BINDING`	`results.*`	Routing key pattern
`AGENT_STALE_MS`	`120000`	Delay to mark agent as offline
`IMAGES_INDEX_PATH`	`/share/_index/images.json`	Path to shared image index
`JWT_AGENT_SECRET`	`supersecret_agent`	JWT secret for agents
`JWT_BROWSER_SECRET`	`supersecret_browser`	JWT secret for browsers
`PUBLIC_WS_BASE`	`wss://console.openhvx.local/api`	Browser WebSocket endpoint
`BROKER_WS_BASE`	`wss://ws.openhvx.local`	Direct agent WebSocket endpoint