Skip to content

NornicDB Issue Index¶

Use this page when you know a symptom, but not the right document yet.

Quick Triage¶

Is the server up? curl http://localhost:7474/health
Can you authenticate? POST /auth/token
Is the issue API-specific? Check the API Reference.
Is the issue operational? Check the Operations Guide.

By Symptom¶

Startup & Connectivity¶

Server won't start / exits immediately
- Troubleshooting → Server won't start (corruption after crash)
- Deployment
Cannot connect to HTTP/Bolt
- Troubleshooting → Cannot connect to server
- Quick Start

Auth & Access¶

401 Unauthorized
- Troubleshooting → 401 Unauthorized
- Security Guide
403 Forbidden / role mismatch

Query & API Errors¶

Cypher behavior/function confusion
- Cypher Queries
- Cypher Functions Reference
HTTP endpoint mismatch
- OpenAPI Reference
Neo4j compatibility question
- Feature Parity
- Cypher Compatibility

Performance & Capacity¶

Slow queries
High memory usage / OOM
- Troubleshooting → High memory usage
- Low-Memory Mode
High CPU usage
- Troubleshooting → High CPU usage
- Performance Overview

Data Integrity & Recovery¶

Data not persisting
- Troubleshooting → Data not persisting
- Backup & Restore
Corruption / recovery after crash
- Troubleshooting → Server won't start (corruption after crash)
- WAL Compaction

Search, Embeddings, and AI¶

Embeddings not generating
- Troubleshooting → Embeddings not generating
- Vector Embeddings
Vector/hybrid search quality issues
Agent/MCP integration issues

Security & Compliance¶

HTTP hardening / SSRF / CSRF / XSS
- HTTP Security
Encryption/audit/RBAC requirements

If You Still Can't Find It¶

Browse by role/task in the Documentation Hub.
Use the section indexes: