feat: add Docker container support with volume mounting (#131)

Co-authored-by: claude[bot] <209825114+claude[bot]@users.noreply.github.com>
Co-authored-by: phernandez <phernandez@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>

Author: 3 people

.env.oauth.example

@@ -1,4 +1,3 @@
-# Generated by https://smithery.ai. See: https://smithery.ai/docs/config#dockerfile
 FROM python:3.12-slim
 
 WORKDIR /app
@@ -10,7 +9,5 @@ COPY . .
 RUN pip install --upgrade pip \
 && pip install . --no-cache-dir --ignore-installed
 
-# Expose port if necessary (e.g., uv might use a port, but MCP over stdio so not needed here)
-
-# Use the basic-memory entrypoint to run the MCP server
-CMD ["basic-memory", "mcp"]
+# Use the basic-memory entrypoint to run the MCP server with default SSE transport
+CMD ["basic-memory", "mcp", "--transport", "sse", "--host", "0.0.0.0", "--port", "8000"]

AUTH.md

@@ -411,6 +411,31 @@ Development versions are automatically published on every commit to main with ve
 pip install basic-memory --pre --force-reinstall
 ```
 
+### Docker
+
+Run Basic Memory in a container with volume mounting for your Obsidian vault:
+
+```bash
+# Clone and start with Docker Compose
+git clone https://github.com/basicmachines-co/basic-memory.git
+cd basic-memory
+
+# Edit docker-compose.yml to point to your Obsidian vault
+# Then start the container
+docker-compose up -d
+```
+
+Or use Docker directly:
+```bash
+docker run -d \
+  --name basic-memory-server \
+  -v /path/to/your/obsidian-vault:/data/knowledge:rw \
+  -v basic-memory-config:/root/.basic-memory:rw \
+  ghcr.io/basicmachines-co/basic-memory:latest
+```
+
+See [Docker Setup Guide](docs/Docker.md) for detailed configuration options, multiple project setup, and integration examples.
+
 ## License
 
 AGPL-3.0