Operations Guide

This section is the canonical runbook set for deploying, operating, and recovering NornicDB.

Start Here

• Production setup: deployment.md
• Runtime configuration: configuration.md
• Environment variables: environment-variables.md
• Reverse proxy and TLS termination: reverse-proxy.md
• Retention policy setup: ../user-guides/retention-policies.md
• Symptom-based triage: troubleshooting.md
• Global issue map: ../issues-index.md

Common Tasks

• Deploy on Docker/Kubernetes: docker.md
• Monitor health/metrics: monitoring.md
• Backup and restore: backup-restore.md
• Control WAL growth and recovery behavior: wal-compaction.md
• Tune durability/performance: durability.md
• Account for memory and choose caps: memory-management.md
• Run low-memory deployments: low-memory-mode.md
• Scale capacity: scaling.md
• Secure cluster communication: cluster-security.md

Related Operational Topics

• MVCC retention and historical reads: ../user-guides/historical-reads-mvcc-retention.md
• Storage encoding format and migration details: storage-serialization.md
• CLI workflows: cli-commands.md
• Offline admin import workflow: admin-tool.md

Incident Routing

• Service down / cannot connect: troubleshooting.md#connection-issues
• Auth errors (401/403): troubleshooting.md#authentication-issues
• Slow queries or high CPU: troubleshooting.md#performance-issues
• OOM or memory pressure: troubleshooting.md#high-memory-usage
• Crash recovery or corruption: troubleshooting.md#data-integrity-recovery