Troubleshooting
Common Issues
⚠️ Port already in use
Another process is using port 8747/8748/8749/8750. Either stop the other process or configure MuninnDB to use different ports in muninndb.yaml.
lsof -i :8747 # Find what's using the port
⚠️ ACTIVATE returns 0 results
This happens when no engrams are above the MinScore threshold. Lower the threshold, or check that engrams are in ACTIVE state.
curl http://localhost:8749/v1/stats # Check engram counts by state
⚠️ Decay not running
The decay worker runs on the configured interval (default 5 minutes). Use the web UI at :8750 to trigger a manual decay run or check worker logs.
⚠️ MCP tools not appearing in Claude
Verify the MCP server config in claude_desktop_config.json is correct and Claude Desktop was restarted after adding it. Check that muninndb is in your PATH.
muninndb mcp # Test MCP mode directly
⚠️ High memory usage
The L1 cache defaults to 10,000 entries. Reduce this in config. Also ensure the Pebble compaction is running — check disk usage.
curl http://localhost:8749/v1/health # Check system health