Environment Variables

Environment Variables

Device and speech routing are often set via the environment so the same binary works on Mac, Pi, and Ada without rewriting YAML.

---

Core device vars

Variable	Purpose	Examples
COMSTAR_CAMERA_SOURCE	Camera for ffmpeg grabber	/dev/video0, avfoundation:1 (Mac)
COMSTAR_MIC_SOURCE	Mic for comstar-audio	sounddevice index or name substring (C525)
COMSTAR_SPEAKER_SOURCE	Local paplay sink when kiosk absent	Pulse/PipeWire sink name; empty = default
COMSTAR_STT_URL	Fallback STT base when Reach speech absent	http://127.0.0.1:8090
COMSTAR_TTS_URL	Fallback TTS base when Reach speech absent	http://127.0.0.1:8091
COMSTAR_SPEECH_TOKEN	Optional bearer for AO speech sidecars	same as Ada AGENTIC_SPEECH_TOKEN
COMSTAR_LOCAL_SPEAKER	Play TTS via paplay without kiosk	1
COMSTAR_VAD_SILENCE_MS	End-of-speech silence	1200 (common Pi override)
COMSTAR_LOG	Log level	debug, info (default), warn, error
COMSTAR_ENV	Dev mode gate	dev required for WS LAN bind / inject
COMSTAR_ADMIN_BIND_LAN	Bind admin HTTP (:8781) to 0.0.0.0	1 on Pi when LAN ops UI needed
COMSTAR_ADMIN_TOKEN	Admin LAN token (X-Comstar-Lan-Token)	Prefer ~/.config/comstar/admin.env
COMSTAR_HOTSPOT	Offline SoftAP when no uplink	0 to disable (ADR 0014)
COMSTAR_OAUTH_BIND_LAN	Allow Google OAuth listener on LAN	when redirect base is a LAN/public host
COMSTAR_DATA_DIR	Override data root	Google tokens under …/google/<userid>.json
COMSTAR_FORCE_WAKE_SCORE	Bypass wake model for bring-up	e.g. 0.99
COMSTAR_TERMINAL_MCP	Enable terminal MCP tunnel bootstrap	1 when proven

Aliases: COMSTAR_CAMERA_INPUT / COMSTAR_CAMERA_DEVICE, COMSTAR_MIC_DEVICE, COMSTAR_SPEAKER_SINK / COMSTAR_AUDIO_SINK.

---

Google OAuth (optional)

Variable	Purpose
GOOGLE_CLIENT_ID	OAuth client ID
GOOGLE_CLIENT_SECRET	OAuth client secret — never commit

→ Google Workspace

---

Ada / AO speech (server side)

Variable	Purpose
AGENTIC_SPEECH_ENABLED	Advertise speech on WS hello
AGENTIC_SPEECH_ADVERTISE_STT_URL	e.g. http://<ada-lan-ip>:8090
AGENTIC_SPEECH_ADVERTISE_TTS_URL	e.g. http://<ada-lan-ip>:8091
AGENTIC_SPEECH_TOKEN	Optional sidecar bearer
AGENTIC_SERVE_SESSION_OVERLAY	Required 1
AGENTIC_SERVE_MCP_TUNNEL	Required 1

---

Mac template

cp config/comstar.mac.env.example config/comstar.mac.env
set -a && source config/comstar.mac.env && set +a

Keep comstar.mac.env out of git.

---

Related pages

• Configuration
• Admin Console
• Speech
• Runbook
• Security