Configuration

All configuration via environment variables. No config file required.

Server

VariableTypeDefaultDescription
DAKERA_ROOT_API_KEYstringBootstrap root API key (super_admin scope). If unset, auth is disabled.
DAKERA_HOSTstring0.0.0.0Bind address
DAKERA_PORTu163300REST API port
DAKERA_GRPC_PORTu1650051gRPC port
RUST_LOGstringinfoLog level: trace/debug/info/warn/error

Storage

VariableDefaultDescription
DAKERA_STORAGEmemoryBackend: memory, filesystem, s3, minio
DAKERA_STORAGE_PATH./dataData directory for filesystem storage
DAKERA_S3_BUCKETS3 bucket name (3–63 chars)
DAKERA_S3_REGIONS3 region (e.g. us-east-1)
DAKERA_S3_ENDPOINTS3-compatible endpoint URL (MinIO)
AWS_ACCESS_KEY_IDAWS / MinIO access key
AWS_SECRET_ACCESS_KEYAWS / MinIO secret key

Embeddings

VariableDefaultDescription
DAKERA_EMBEDDING_MODELMiniLML6V2ONNX model: MiniLML6V2, BGESmallENV15, E5SmallV2
DAKERA_INFERENCE_DEVICEcpucpu or cuda

Memory & decay

VariableDefaultDescription
DAKERA_DECAY_ENABLEDtrueEnable memory importance decay over time
DAKERA_DECAY_HALF_LIFE_SECS604800Half-life for decay (default: 7 days)
DAKERA_AUTOPILOT_ENABLEDfalseEnable AutoPilot memory lifecycle management

Retrieval tuning

VariableDefaultDescription
DAKERA_RRF_K60Reciprocal Rank Fusion k-parameter
DAKERA_ML_CLASSIFIERfalseEnable ML-based query classifier
DAKERA_TEMPORAL_INFERENCEtrueEnable per-query temporal boost (requires ML_CLASSIFIER)
DAKERA_INFERENCE_TEMPORAL_MULT_BETA0.65Multiplicative temporal scaling factor
DAKERA_ENTITY_VECTOR_SEARCHtrueEnable entity-filtered second HNSW pass merged via RRF
DAKERA_HNSW_CACHE_MAX50Max HNSW indexes in LRU cache

Auth, rate limiting & observability

VariableDefaultDescription
RATE_LIMIT_RPS100Requests per second
RATE_LIMIT_BURST50Burst capacity
DAKERA_AUTH_ENABLEDtrueEnable API key authentication
DAKERA_CORS_ORIGINS*Allowed CORS origins (comma-separated)
DAKERA_TRACING_ENABLEDfalseEnable OpenTelemetry tracing
OTEL_EXPORTER_OTLP_ENDPOINThttp://localhost:4317OTLP collector endpoint
DAKERA_AUDIT_LOGfalseEnable audit logging

Observability & monitoring

Dakera exports OpenTelemetry traces and Prometheus metrics. Configure OTEL to send traces to Jaeger, Grafana Tempo, or any OTLP-compatible collector:

VariableDefaultDescription
DAKERA_TRACING_ENABLEDfalseEnable OpenTelemetry distributed tracing
OTEL_EXPORTER_OTLP_ENDPOINThttp://localhost:4317OTLP gRPC collector endpoint (Jaeger, Tempo, etc.)
OTEL_SERVICE_NAMEdakeraService name in traces
OTEL_RESOURCE_ATTRIBUTESAdditional resource attributes (e.g. deployment.environment=prod)
DAKERA_METRICS_PORT3300Port serving /metrics (Prometheus format)

Prometheus scrape config: target dakera:3300/metrics. 13 built-in metrics covering request latency, cache hit rates, vector index size, memory count, and replication lag.

Backup configuration

Scheduled backups create encrypted, compressed snapshots of all data. Backups include vector indexes, memories, knowledge graph, and configuration.

VariableDefaultDescription
DAKERA_BACKUP_ENABLEDfalseEnable scheduled automatic backups
DAKERA_BACKUP_INTERVAL86400Backup interval in seconds (default: 24 hours)
DAKERA_BACKUP_PATH./backupsDirectory for backup files (local or mounted volume)
DAKERA_BACKUP_RETENTION7Number of backup snapshots to retain
DAKERA_BACKUP_ENCRYPTtrueAES-256 encrypt backup files (uses DAKERA_ROOT_API_KEY as KDF input)

Backups use zstd compression (~5x reduction). Trigger manual backups via dk admin backup or POST /admin/backup.