00-overview Add Vue UI scaffold with gnexus-ui-kit dependency 6 months ago
10-systems Incident series: added Episode 14 (22:31–22:32 UTC, 66s ConnectTimeout — longest of series); corrected 3-min cron hypothesis (no cron on bserv, only PCP timers) 1 month ago
40-inventory Add Liebert PSI UPS (USB on DL380 G6, NUT myups) to inventory and docs 1 month ago
60-generated Add documentation foundation and backend maintenance API 6 months ago
90-maintenance Incident series: added Episode 14 (22:31–22:32 UTC, 66s ConnectTimeout — longest of series); corrected 3-min cron hypothesis (no cron on bserv, only PCP timers) 1 month ago
nginx Deploy: add nginx, systemd services, scripts, MCP info endpoint 6 months ago
schemas Make docs optional in host schema and disable missing-doc-link-target validation 6 months ago
scripts Deploy: add nginx, systemd services, scripts, MCP info endpoint 6 months ago
server fix(server): prevent poisoned pending-changes (validate before write, full rollback, delete tool) 1 month ago
systemd Deploy: add nginx, systemd services, scripts, MCP info endpoint 6 months ago
ui Prevent standalone UI buttons from stretching 6 months ago
.gitignore Add documentation foundation and backend maintenance API 6 months ago
README.md merge 6 months ago
README.md

gnexus-book

Knowledge base for documenting personal digital and server infrastructure.

Planning

Foundation

Deployment

Quick start (this machine)

./scripts/install.sh
  • Backend (FastAPI): systemctl --user status gnexus-book-backend.service — listens on 0.0.0.0:8000
  • Frontend (nginx): served on port 80 from /var/www/gnexus-book
  • MCP Server (SSE): systemctl --user status gnexus-book-mcp.service — listens on 0.0.0.0:8001, endpoint /sse

Update / redeploy

./scripts/deploy.sh

Nginx (production)

A sample nginx config is provided in nginx/gnexus-book.conf. To use it:

sudo apt install nginx
sudo cp nginx/gnexus-book.conf /etc/nginx/sites-available/
sudo ln -s /etc/nginx/sites-available/gnexus-book.conf /etc/nginx/sites-enabled/
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t && sudo systemctl reload nginx

Nginx will serve the built UI from /var/www/gnexus-book and proxy /api/ to the backend on port 8000.

Server

UI