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/.GNEXUS_BOOK_MCP_TOKEN is a break-glass token, not the normal agent credential./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, tracking origin/master).http://192.168.1.170:8000/, MCP streamable HTTP at /mcp-protocol/, UI http://192.168.1.170/ via nginx, PostgreSQL canonical store, healthcheck and backup timers.GNEXUS_BOOK_FILE_BACKEND_FROZEN=true; the checkout remains a read-only rollback source.deployed-2026-11-20 tag archives the deployment commit.gnexus_book is the canonical store, with immutable document and inventory versions grouped into changesets.owner_user_id. Current rows are assigned to the bootstrap administrator; transfer to the real owner is pending production authentication. Historical import authorship remains system/importer.server/.server/app/mcp_http.py, streamable HTTP at /mcp-protocol/.ui/, using gnexus-ui-kit; nginx serves the built bundle.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/ (personal key required; no SSE endpoint).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, healthcheck, daily backup and monthly restore drill. The frontend unit on :3006 is a legacy Vite preview; the public UI is the static bundle served by nginx on port 80.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 legacy pending-change JSON files, plus a git bundle --all.master now tracks origin/master; the Git backup is no longer the only copy of recent history. Keep the legacy backup until the file backend is decommissioned.PostgreSQL backup and recovery:
pg_dump through gnexus-book-backup.timer; retention is configured by GNEXUS_BOOK_BACKUP_KEEP.gnexus_book_2026-11-20_151745.dump under /mnt/NetTera8/service/backups/gnexus-book/db/target-gnbook/.SYNAPSE_URL/SYNAPSE_API_KEY are not configured on this host yet.After the cutover, the file pending-change records were treated as legacy:
/mnt/NetTera8/service/backups/gnexus-book/legacy-pending-changes/2026-11-20/ with a SHA-256 checksum and a metadata manifest;GET /health follows the platform contract (status, checks.db, service, version, timestamp); it is public and contains no personal data.gnexus-book-healthcheck.timer runs scripts/healthcheck.sh every five minutes. It checks /health, the database check and the backup filesystem.sub are not configured; data is still owned by the bootstrap administrator.book.gnexus.space does not resolve and public HTTPS is not configured. The MCP allowlist already contains the public host and origin.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: