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
• 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
• 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

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