diff --git a/README.md b/README.md
index b74ba4e..cb89f04 100644
--- a/README.md
+++ b/README.md
@@ -299,7 +299,7 @@ curl -fsSL https://raw.githubusercontent.com/cheikh2shift/godex/main/docker-comp
 mkdir -p workspace
 
 # Run
-docker compose up -d
+WORKSPACE_DIR="$PWD" docker compose up -d
 docker attach godex
 ```
 
@@ -307,7 +307,7 @@ docker attach godex
 
 1. **First run** - The container will launch the wizard to configure your provider:
    ```bash
-   docker compose up
+   WORKSPACE_DIR="$PWD" docker compose up
    ```
    Configure your Ollama/OpenRouter/etc. settings when prompted.
    If the screen looks empty after attaching, press enter key to trigger TUI redraw.
@@ -329,9 +329,11 @@ sudo systemctl restart ollama
 
 2. **Subsequent runs** - Your config is persisted in a Docker volume:
    ```bash
-   docker compose up
+   WORKSPACE_DIR="$PWD" docker compose up
    ```
 
+**Note:** `WORKSPACE_DIR` controls which host directory is mounted at `/workspace` in the container. Set it to the directory you want GoDex to operate in (defaults to the compose file directory if unset).
+
 3. **Edit provider config in the Docker volume**:
    The volume is explicitly named `godex-config` so it’s shared across projects.
    ```bash
diff --git a/docker-compose.yml b/docker-compose.yml
index 0f9e63f..bd1c0ed 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -27,7 +27,7 @@ services:
       # Optional: set to auto-select provider after wizard creates config
       # - CODEX_PROVIDER_NAME=my-local-identifier
     volumes:
-      - .:/workspace
+      - ${WORKSPACE_DIR:-.}:/workspace
       - godex-config:/godex-home/.godex
     working_dir: /workspace
     stdin_open: true
diff --git a/install-docker.sh b/install-docker.sh
index 8410953..501310e 100755
--- a/install-docker.sh
+++ b/install-docker.sh
@@ -35,10 +35,10 @@ echo "Setup complete!"
 echo ""
 echo "To run GoDex in your project directory:"
 echo ""
-echo "  docker compose -f ${INSTALL_DIR}/docker-compose.yml up -d && docker attach godex"
+echo "  WORKSPACE_DIR=\"$PWD\" docker compose -f ${INSTALL_DIR}/docker-compose.yml up -d && docker attach godex"
 echo ""
 echo "  # Add this alias to ~/.bashrc or ~/.zshrc:"
-echo "  alias godex='docker compose -f ${INSTALL_DIR}/docker-compose.yml up -d && docker attach godex'"
+echo "  alias godex='WORKSPACE_DIR=\"$PWD\" docker compose -f ${INSTALL_DIR}/docker-compose.yml up -d && docker attach godex'"
 echo ""
 echo "  # Then run from any directory:"
 echo "  godex"