feat(docker): keep results in a host folder when TRADINGAGENTS_DATA_DIR is set (#865)

- both compose services mount ${TRADINGAGENTS_DATA_DIR:-tradingagents_data}; unset keeps the named volume
- README and .env.example show the setting

.env.example

@@ -47,6 +47,9 @@ NVIDIA_API_KEY=
 #TRADINGAGENTS_MAX_RISK_ROUNDS=1
 #TRADINGAGENTS_CHECKPOINT_ENABLED=false
 
+# Docker: a host folder for results, reports and the memory log (unset: the tradingagents_data volume).
+#TRADINGAGENTS_DATA_DIR=./data
+
 # Paths and alpha benchmark. Unset uses ~/.tradingagents and the regional index.
 #TRADINGAGENTS_RESULTS_DIR=
 #TRADINGAGENTS_CACHE_DIR=

README.md

@@ -144,6 +144,8 @@ docker compose run --rm tradingagents
 
 After updating the repository, rebuild the image with `docker compose build`.
 
+Results, reports, the memory log and the cache live in the `tradingagents_data` volume. To keep them in a folder on the host instead, create the folder and point `TRADINGAGENTS_DATA_DIR` at it, in `.env` or the shell: `mkdir -p data && TRADINGAGENTS_DATA_DIR=./data docker compose run --rm tradingagents`.
+
 For local models with Ollama:
 ```bash
 docker compose --profile ollama run --rm tradingagents-ollama

docker-compose.yml

@@ -4,7 +4,7 @@ services:
     env_file:
       - .env
     volumes:
-      - tradingagents_data:/home/appuser/.tradingagents
+      - ${TRADINGAGENTS_DATA_DIR:-tradingagents_data}:/home/appuser/.tradingagents
     tty: true
     stdin_open: true
 
@@ -23,7 +23,7 @@ services:
       - TRADINGAGENTS_LLM_PROVIDER=ollama
       - OLLAMA_BASE_URL=http://ollama:11434/v1
     volumes:
-      - tradingagents_data:/home/appuser/.tradingagents
+      - ${TRADINGAGENTS_DATA_DIR:-tradingagents_data}:/home/appuser/.tradingagents
     depends_on:
       - ollama
     tty: true