gnexus-book

Knowledge base for documenting personal digital and server infrastructure.

Planning

• Project implementation notes
• MVP implementation plan

Foundation

• Documentation rules
• Freshness checks
• Hardware inventory
• Virtual machine inventory
• Traffic routes
• Endpoints
• Integrations
• Projects

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

• Server README

UI

• UI README