@Eugene Sukhodolskiy Eugene Sukhodolskiy authored 5 hours ago
00-overview docs: switch book to production gnexus-auth and real owner 5 hours ago
10-systems docs: switch book to production gnexus-auth and real owner 5 hours ago
30-runbooks docs: switch book to production gnexus-auth and real owner 5 hours ago
40-inventory Merge PostgreSQL migration with gnbook knowledge history 6 hours ago
50-decisions docs: add PostgreSQL storage ADR and migration roadmap 1 day ago
60-generated Add documentation foundation and backend maintenance API 6 months ago
90-maintenance chore: archive legacy pending changes after database cutover 5 hours ago
nginx fix(security): harden internal API, MCP scopes and host checks 1 day ago
schemas Make docs optional in host schema and disable missing-doc-link-target validation 6 months ago
scripts feat(ops): schedule health checks and alert on backup disk usage 5 hours ago
server docs: record production freeze, operations and rollback state 5 hours ago
systemd feat(ops): schedule health checks and alert on backup disk usage 5 hours ago
ui refactor(ui): move to Vue SFC pages and navigation shell 5 hours ago
.gitignore chore: track updated ui lock and ignore owner JSON 6 hours ago
CLAUDE.md docs: record production freeze, operations and rollback state 5 hours ago
README.md docs: add operations and decommission runbooks 1 day 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 (streamable HTTP): systemctl --user status gnexus-book-mcp.service — listens on 0.0.0.0:8001, endpoint /mcp-protocol/
  • Database: PostgreSQL; daily off-host backups run through gnexus-book-backup.timer (operations)

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