Newer
Older
gnexus-book / 10-systems / applications / gnexus-book.md

owner: gmikcon status: active last_reviewed: 2026-09-05 review_interval: 30d confidence: high

source_of_truth: ssh-host-verified

Gnexus Book

Gnexus Book is the canonical infrastructure knowledge base and maintenance API for the personal digital and server infrastructure.

Deployment

  • Runs as KVM VM gnbook (192.168.1.170) on hypervisor hp-proliant-dl380-g6 (192.168.1.130).
  • SSH: ubuntu on 192.168.1.170 (credentials in gnexus-creds, secret gnauth-gnbook-ssh).
  • Repository path: /home/ubuntu/gnexus-book (branch master).
  • Source of truth: Markdown, YAML inventory, JSON Schema, and Git history.

Runtime Components

  • Backend: FastAPI under server/.
  • Agent interface: MCP server under server/app/mcp_server.py.
  • UI: Vue/Vite under ui/.
  • UI dependency: gnexus-ui-kit.

Endpoints

  • REST API: http://192.168.1.170:8000/ (uvicorn, openapi at /openapi.json).
  • MCP (SSE): http://192.168.1.170:8001/sse.
  • UI (LAN): http://192.168.1.170:80/ (nginx serves the built SPA).
  • Services run as user-level systemd units under user@1000.service: gnexus-book-backend.service (uvicorn :8000) and gnexus-book-mcp.service (MCP server).

Maintenance Model

Agents should prefer structured inventory changes, validation, pending changes, and local commits through the maintenance API.

Pending-change queue lives in 90-maintenance/pending-changes/ (untracked JSON files; 11 older ones are git-tracked). Repository-wide validation scans every pending JSON, so a single invalid pending file blocks all applies and commits.

For agent-facing MCP usage rules, see ../../90-maintenance/agent-mcp-usage.md.

No raw credentials are documented here.