Configuration

MuninnDB is configured via CLI flags and environment variables. No config file needed — all defaults are sensible for development. Use flags for server options and environment variables for secrets and plugins.

Server Flags

Used with muninn start:

muninn start — flags reference

--data <dir>        Data directory            default: ~/.muninn/data
--mbp-addr <addr>  MBP TCP listen address   default: :8474
--rest-addr <addr> REST HTTP listen address  default: :8475
--grpc-addr <addr> gRPC listen address       default: :8477
--mcp-addr <addr>  MCP listen address        default: :8750
--mcp-token <tok>  Bearer token for MCP auth (empty = no auth)
--log-level <lvl>  Log level: debug, info, warn, error  default: info
--dev              Serve web assets from ./web (hot-reload)

Environment Variables

Embedders — enable semantic similarity search (one at a time, priority order)

MUNINN_OLLAMA_URL=ollama://localhost:11434/nomic-embed-text  # local, no key
MUNINN_OPENAI_KEY=sk-...                                     # text-embedding-3-small
MUNINN_VOYAGE_KEY=pa-...                                     # voyage-3

LLM Enrichment — auto-extract summaries, entities, and relationships

# URL scheme selects the provider:
MUNINN_ENRICH_URL=ollama://localhost:11434/llama3.2           # local, no key
MUNINN_ENRICH_URL=openai://gpt-4o-mini
MUNINN_ENRICH_API_KEY=sk-...
MUNINN_ENRICH_URL=anthropic://claude-haiku-4-5-20251001
MUNINN_ANTHROPIC_KEY=sk-ant-...  # alias for MUNINN_ENRICH_API_KEY

Other

MUNINNDB_DATA=<dir>       Override default data directory
MUNINN_CORS_ORIGINS=<o>  Comma-separated allowed CORS origins

Default Ports

Port	Protocol	Use
:8474	MBP (binary TCP)	Native SDK — fastest, lowest latency
:8475	REST (HTTP/JSON)	curl, scripts, REST clients
:8476	Web UI (HTTP)	Dashboard, priority charts, relationship graph
:8477	gRPC	Protobuf interface for polyglot teams
:8750	MCP (HTTP/JSON-RPC)	Claude Desktop, Cursor, Windsurf, VS Code