owner: gmikcon status: active last_reviewed: 2026-11-20 review_interval: 30d confidence: high
Gnexus Book is the canonical infrastructure knowledge base and maintenance API for the personal digital and server infrastructure.
mcp_* keys over streamable HTTP at /mcp-protocol/./internal/keys, protected by a service secret, blocked in nginx.gnbook (192.168.1.170) on hypervisor hp-proliant-dl380-g6 (192.168.1.130).ubuntu on 192.168.1.170; credentials live in gnexus-creds as gnauth-gnbook-ssh./home/ubuntu/gnexus-book (branch master).http://192.168.1.170:8000/, MCP SSE on :8001/sse, UI http://192.168.1.170/ via nginx, file-backed storage./mcp-protocol/, PostgreSQL as the canonical store, SSO enforced when configured.gnexus_book is the target canonical store, with immutable document and inventory versions grouped into changesets.owner_user_id. Current data is assigned to the first admin user (sub=1, superadmin); historical import authorship remains system/importer.server/.server/app/mcp_http.py, streamable HTTP at /mcp-protocol/.ui/, using gnexus-ui-kit.http://192.168.1.170:8000/ (uvicorn).http://192.168.1.170/ (nginx serves the built SPA and proxies /api/, /auth/, /webhooks/gnexus-auth, /mcp-protocol/).http://192.168.1.170:8001/mcp-protocol/.127.0.0.1:3005, UI 127.0.0.1:3006, MCP 127.0.0.1:8001/mcp-protocol/.user@1000.service: backend, frontend, MCP, daily backup, optional monthly restore drill.Legacy file-level backup (set up 2026-10-09):
/home/ubuntu/gnexus-book-backup.sh on gnbook; full repo tar.gz including .git, modified inventory, and untracked pending-change JSON files, plus a git bundle --all.master is ahead of origin/master by 309 commits, so local backups are currently the only copy of recent history.PostgreSQL backup and recovery:
pg_dump through gnexus-book-backup.timer; retention is configured by GNEXUS_BOOK_BACKUP_KEEP.syn_* source key is configured.The file backend has poisoned-pending protection (commit c77bcb1, 2026-09-24):
delete_pending_change / DELETE /changes/{id} deletes pending or corrupt records;corrupt, can be deleted, cannot be applied;update_doc cleans up its pending JSON if apply or commit fails.In database mode the equivalent unit is a draft changeset; deletion is allowed only while it is still a draft.
GET /health follows the platform contract (status, checks.db, service, version, timestamp); it is public and contains no personal data.scripts/healthcheck.sh.Agents should prefer structured inventory changes, validation, draft changesets and apply/publish through the maintenance API or MCP. For MCP rules see ../../90-maintenance/agent-mcp-usage.md.
Deployment and cutover: