diff --git a/DOCKER.md b/DOCKER.md
index 5ee8829c..e2647503 100644
--- a/DOCKER.md
+++ b/DOCKER.md
@@ -68,6 +68,8 @@ SERENA_DASHBOARD_PORT=8080 docker-compose up serena
    docker-compose up serena-dev
    ```
 
+Note: Edit the `compose.yaml` file to customize volume mounts for your projects.
+
 ### Using Docker directly
 
 ```bash
@@ -83,6 +85,24 @@ docker run -it --rm \
   serena
 ```
 
+### Using Docker Compose with Merge Compose files
+
+To use Docker Compose with merge files, you can create a `compose.override.yml` file to customize the configuration:
+
+```yaml
+services:
+  serena:
+    # To work with projects, you must mount them as volumes:
+    volumes:
+      - ./my-project:/workspace/my-project
+      - /path/to/another/project:/workspace/another-project
+    # Add the context for the IDE assistant option:
+    command:
+      - "uv run --directory . serena-mcp-server --transport sse --port 9121 --host 0.0.0.0 --context ide-assistant"
+```
+
+See the [Docker Merge Compose files documentation](https://docs.docker.com/compose/how-tos/multiple-compose-files/merge/) for more details on using merge files.
+
 ## Accessing the Dashboard
 
 Once running, access the web dashboard at:
diff --git a/compose.yaml b/compose.yaml
index bb8f683e..48923e27 100644
--- a/compose.yaml
+++ b/compose.yaml
@@ -1,6 +1,10 @@
 services:
   serena:
     image: serena:latest
+    # To work with projects, you must mount them as volumes:
+    # volumes:
+      # - ./my-project:/workspace/my-project
+      # - /path/to/another/project:/workspace/another-project
     build:
       context: ./
       dockerfile: Dockerfile
@@ -12,6 +16,8 @@ services:
       - SERENA_DOCKER=1
     command:
       - "uv run --directory . serena-mcp-server --transport sse --port 9121 --host 0.0.0.0"
+      # Add the context for the IDE assistant
+      # - "uv run --directory . serena-mcp-server --transport sse --port 9121 --host 0.0.0.0 --context ide-assistant"
 
   serena-dev:
     image: serena:dev