docs: document paseo env overrides

2025-11-30 02:49:55 +00:00
parent b8d942cb6b
commit fa84d4c0c9
2 changed files with 19 additions and 0 deletions
@@ -14,6 +14,17 @@ This is an npm workspace monorepo:
 - **packages/server**: Backend server (Express + WebSocket API)
 - **packages/app**: Cross-platform app (Expo - iOS, Android, Web)

+## Environment overrides
+
+- `PASEO_HOME` – path for runtime state such as `agents.json`. Defaults to `~/.paseo`; set this to a unique directory (e.g., `~/.paseo-blue`) when running a secondary server instance.
+- `PASEO_PORT` – preferred voice server + MCP port. Overrides `PORT` and defaults to `6767`. Use distinct ports (e.g., `7777`) for blue/green testing.
+
+Example blue/green launch:
+
+```
+PASEO_HOME=~/.paseo-blue PASEO_PORT=7777 npm run dev
+```
+
 ## Running and checking logs

 We run the mobile app and server in the tmux session `voice-dev`: