Newer
Older
gnexus-book / 10-systems / services / navi-zoe.md

owner: gmikcon status: active last_reviewed: 2026-09-10 review_interval: 90d confidence: high

source_of_truth: deployment-verified

Navi zoe (192.168.1.176)

Navi instance zoe deployed on the libvirt VM service (hypervisor hp-proliant-dl380-g6). Deployed 2026-09-10 by rei on request of the owner.

Deployment

  • Method: git clone -b deploy https://git.gnexus.space/git/root/navi-1.git + bash deploy/install.sh (idempotent).
  • Repo: /home/ubuntu/navi-1 on the VM, branch deploy.
  • Python: standalone CPython 3.12.14 in ~/navi-1/.python (system python is 3.10, untouched).
  • API server: systemd unit navi.service, Restart=always, binds 0.0.0.0:8099.
  • PostgreSQL: docker container navi-postgres (pgvector image), 127.0.0.1:5432, volume navi-pgdata.
  • Terminal client: navi-code symlinked into /usr/local/bin.
  • Web UI: off (NAVI_WEBCLIENT_ENABLED=false), auth off (NAVI_AUTH_ENABLED=false) — LAN-trusted module.

Swarm

  • Hive: http://192.168.1.168:8087 (HIVE_URL in .env), announce interval 120 s.
  • Swarm key: .swarm-key copied from the hive host (rei on 192.168.1.168); not stored here.
  • Instance identity: instance.json, name zoe, instance_id 72a27598-d648-4b13-9caf-8ad195a838da.

LLM / embeddings

  • Chat LLM: Ollama Cloud (OLLAMA_HOST=https://ollama.com), default model glm-5.3-flash:cloud; API key stored in .env on the VM (not documented here).
  • Embeddings: local Ollama http://192.168.1.168:11434 (EMBEDDING_OLLAMA_HOST), model nomic-embed-text:latest.

MCP integrations

  • gnexus-book (17 tools) and gnexus-creds (7 tools) registered at startup.
  • Note: mcp python package pinned to 1.27.1 — version 2.2.0 breaks startup MCP registration ('Tool' object has no attribute 'inputSchema').

Access

  • SSH: user ubuntu, password shared with other DL380 VMs — see gnexus-creds secret gnauth-gnbook-ssh. sudo requires password (use ssh -tt + sudo -S for non-interactive installs).
  • Health: curl http://192.168.1.176:8099/health.

Day-2 operations

systemctl status navi
journalctl -u navi -f
sudo docker compose -f deploy/docker-compose.yml --env-file .env ps

Updating: git pull && bash deploy/install.sh && sudo systemctl restart navi.