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.
https://auth.gnexus.space. The production client gnexus-book is registered with the LAN redirect http://192.168.1.170/auth/callback until public HTTPS is available; cookie secure is false for that redirect.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 real production owner, sub=1 (gnexus-auth superadmin). Historical import authorship remains system/importer.User role. Book authorization is still "authenticated and non-blocked may write"; finer service-side roles are not enforced yet.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.book.gnexus.space does not resolve and public HTTPS is not configured. The MCP allowlist already contains the public host and origin; the auth client uses the LAN callback until the public site exists.editor, docs.write, inventory.write) are not created or enforced yet; the client has the default User role.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: