docs: update Docker docs to use --init flag and fix container cleanup issues

This commit is contained in:
czlonkowski
2025-07-18 19:22:02 +02:00
parent 6e52afd5af
commit 04e0739bbd
2 changed files with 15 additions and 11 deletions

View File

@@ -136,7 +136,7 @@ For local Claude Desktop integration without HTTP:
```bash ```bash
# Run in stdio mode (interactive) # Run in stdio mode (interactive)
docker run --rm -i \ docker run --rm -i --init \
-e MCP_MODE=stdio \ -e MCP_MODE=stdio \
-v n8n-mcp-data:/app/data \ -v n8n-mcp-data:/app/data \
ghcr.io/czlonkowski/n8n-mcp:latest ghcr.io/czlonkowski/n8n-mcp:latest
@@ -152,6 +152,7 @@ Configure Claude Desktop:
"run", "run",
"--rm", "--rm",
"-i", "-i",
"--init",
"-e", "MCP_MODE=stdio", "-e", "MCP_MODE=stdio",
"-v", "n8n-mcp-data:/app/data", "-v", "n8n-mcp-data:/app/data",
"ghcr.io/czlonkowski/n8n-mcp:latest" "ghcr.io/czlonkowski/n8n-mcp:latest"

View File

@@ -129,34 +129,37 @@ networks:
driver: bridge driver: bridge
``` ```
### Container Name Conflicts ### Container Cleanup Issues (Fixed in v2.7.20+)
**Symptoms:** **Symptoms:**
- Error: "Container with name '/n8n-mcp-container' already exists" - Containers accumulate after Claude Desktop restarts
- Claude Desktop shows duplicate containers - Containers show as "unhealthy" but don't clean up
- `--rm` flag doesn't work as expected
**Root Cause:** Claude Desktop bug that spawns containers twice. **Root Cause:** Fixed in v2.7.20 - containers weren't handling termination signals properly.
**Solutions:** **Solutions:**
1. **Remove container name (Recommended):** 1. **Update to v2.7.20+ and use --init flag (Recommended):**
```json ```json
{ {
"command": "docker", "command": "docker",
"args": [ "args": [
"run", "-i", "--rm", "run", "-i", "--rm", "--init",
// Remove: "--name", "n8n-mcp-container",
"ghcr.io/czlonkowski/n8n-mcp:latest" "ghcr.io/czlonkowski/n8n-mcp:latest"
] ]
} }
``` ```
2. **Manual cleanup when it happens:** 2. **Manual cleanup of old containers:**
```bash ```bash
docker rm -f n8n-mcp-container # Remove all stopped n8n-mcp containers
docker ps -a | grep n8n-mcp | grep Exited | awk '{print $1}' | xargs -r docker rm
``` ```
3. **Use HTTP mode instead** (avoids the issue entirely) 3. **For versions before 2.7.20:**
- Manually clean up containers periodically
- Consider using HTTP mode instead
### n8n API Connection Issues ### n8n API Connection Issues