docs: add Docker deployment guide

[groksrc]

Add comprehensive Docker documentation covering:

• Quick start with pull/run commands
• Docker Compose example
• Volume mounts and environment variables
• SSE transport configuration
• Troubleshooting section
• Security notes (non-root execution)

Uses 'basic-container' as container name to disambiguate from 'basic-memory' CLI command in examples.

[claude]

Pull Request Review: Docker Deployment Guide

Summary

This PR adds comprehensive Docker documentation for Basic Memory. The documentation is well-structured, thorough, and follows the established patterns in the codebase.

---

✅ Strengths

Documentation Quality

• Excellent structure: Clear progression from quick start → configuration → troubleshooting
• Comprehensive coverage: Covers all essential topics (images, volumes, environment variables, SSE transport, security)
• Good use of callouts: Appropriate use of Warning/Note/Tip components to highlight important information
• Consistent style: Matches the tone and formatting of existing guides
• Navigation integration: Properly added to navigation.ts in the Guides section

Technical Accuracy

• Correct use of container naming (basic-container) to disambiguate from CLI command
• Accurate port configuration (8000)
• Proper volume mount documentation
• Good security practices highlighted (non-root execution)
• Clear distinction between SSE and stdio transport modes

User Experience

• Warning callout at the top immediately clarifies this is for SSE server deployments, not local stdio use
• Multiple connection methods documented (quick start, Docker Compose)
• Health check examples provided
• CLI command examples show both container name and CLI command clearly

---

🔍 Minor Observations

Component Import Issue

Line 7: The import includes Step but it's not exported from components/index.ts

// Current
import { Card, CardGroup, Info, Warning, Note, Tip, Steps, Step, CodeGroup, CodeTab } from '@/components'

// Should be (based on src/components/index.ts)
import { Card, CardGroup, Info, Warning, Note, Tip, Steps, CodeGroup, CodeTab } from '@/components'

The Steps component exports its own Step children internally, so importing Step separately is unnecessary and causes a build issue.

Navigation Placement

The Docker guide is placed at the end of the Guides section (line 50). Consider whether it should be positioned earlier, perhaps after "CLI Reference" or near "Basic Memory Cloud", since Docker is a deployment/infrastructure concern that users might look for early in their journey.

Current order:

1. Basic Memory Cloud
2. Cloud Sync
3. Knowledge Format
4. MCP Tools Reference
5. Canvas
6. CLI Reference
7. AI Assistant Guide
8. Docker ← New addition

Suggested order (optional):

1. Basic Memory Cloud
2. Cloud Sync
3. Docker ← Infrastructure/deployment
4. Knowledge Format
5. MCP Tools Reference
6. ...

---

✨ Suggestions for Enhancement (Optional)

1. Add Example Use Cases Section

Consider adding a brief section on when to use Docker vs other installation methods:

• CI/CD pipelines
• Team/enterprise deployments
• Development/testing environments
• Kubernetes/orchestration scenarios

2. Link to Cloud Documentation

Since the Docker image runs SSE transport (similar to cloud), consider adding a cross-reference to the Cloud guide for users interested in managed hosting.

3. Environment Variables Table

The environment variables table is good. Consider adding:

• BASIC_MEMORY_LOG_LEVEL (if supported)
• Any database connection variables for PostgreSQL/Neon support mentioned in CLAUDE.md

4. Multi-Project Support

Since v0.17.x supports multi-project, consider adding an example of running multiple containers for different projects or how project switching works in Docker.

---

🔒 Security Review

✅ Good practices documented:

• Non-root execution (UID/GID 1000)
• Custom UID/GID build arguments
• Volume permission troubleshooting
• Slim base image

No security concerns identified.

---

🧪 Testing Considerations

The documentation would benefit from validation that:

1. All Docker commands execute successfully
2. The GHCR image actually exists at ghcr.io/basicmachines-co/basic-memory:latest
3. Version tags (0.17.5, 0.17) are published
4. Health check endpoint responds at /health
5. SSE endpoint works at /mcp

---

📊 Overall Assessment

Code Quality: ⭐⭐⭐⭐⭐ (5/5)
Documentation: ⭐⭐⭐⭐⭐ (5/5)
User Experience: ⭐⭐⭐⭐⭐ (5/5)

This is high-quality documentation that follows best practices and provides significant value to users deploying Basic Memory in containerized environments.

---

✅ Recommendation

APPROVE with minor fix required

Required Change:

• Fix the component import on line 7 (remove Step from imports)

Optional Improvements:

• Consider navigation placement
• Add use case examples
• Validate Docker images exist in GHCR

Once the import fix is applied, this PR is ready to merge. Great work! 🎉