docs: update Docker docs to use --init flag and fix container cleanup issues
This commit is contained in:
@@ -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"
|
||||||
|
|||||||
@@ -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
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user