Newer
Older
gnexus-book / 10-systems / hosts / gntasks.md

title: "VPS gntasks (navi instance ayame)" type: host ip: 192.168.1.179 purpose: "Navi agent instance (ayame, profile navi_code) + gntodo (GNexus Tasks) web service in home LAN" owner: gmikcon status: active confidence: 100 last_reviewed: 2026-09-21 review_interval: 90d

source_of_truth: ssh-host-and-owner-confirmed

VPS gntasks (navi instance ayame + gntodo)

Overview

Home LAN VPS (KVM/QEMU guest). Hosts the navi-1 agent instance ayame (profile navi_code), deployed 2026-09-21 by navi (rei) from the deploy branch of https://git.gnexus.space/git/root/navi-1.git, and since 2026-09-21 the gntodo (GNexus Tasks) web service — deployed by ayame (peer task, verified by rei) from https://git.gnexus.space/git/root/gnexus-tasks.git.

Technical Details

  • IP: 192.168.1.179
  • Hostname: gntasks
  • OS: Ubuntu 22.04.5 LTS, kernel 5.15.0-191-generic
  • Platform: KVM guest, 2 vCPU, 3.8 GiB RAM, 31G root disk (22G free at deploy)
  • User: ubuntu (SSH + sudo, same password; root password identical)
  • Credentials: gnexus-creds secret "VPS gntasks SSH (192.168.1.179)" (id e4e28fe1-c9ac-4bb9-a462-0d57bce13692)
  • Firewall: ufw inactive (all LAN traffic allowed)
  • Instance name: ayame
  • Instance ID: 1606fff0-5abc-468c-af57-6c3c316494ac
  • Repo: /home/ubuntu/navi-1 (branch deploy, commit e276b1e)
  • Service: navi.service (systemd, enabled, Restart=always, runs as root)
  • Server port: 8099 (0.0.0.0), health endpoint http://127.0.0.1:8099/health
  • Postgres: docker container navi-postgres (pgvector) on 127.0.0.1:5432
  • Python: standalone CPython 3.12.14 at /home/ubuntu/navi-1/.python/
  • Swarm: .swarm-key copied from hive host (rei, 192.168.1.168); HIVE_URL=http://192.168.1.168:8087; hive.announce_ok confirmed in journalctl; visible in peer list as ayame — 192.168.1.179:8099 [online]
  • Ollama backend: OLLAMA_HOST=https://ollama.com, model glm-5.3-flash:cloud (deploy-branch .env); OLLAMA_API_KEY appended from hive .env
  • Embeddings: EMBEDDING_OLLAMA_HOST=http://192.168.1.168:11434 — embed.ok=true in /health (better than other instances, which show embed.ok=false)
  • Webclient/auth: NAVI_WEBCLIENT_ENABLED=false, NAVI_AUTH_ENABLED=false (default deploy shape)

gntodo / GNexus Tasks (deployed 2026-09-21)

  • Repo: /srv/gntodo (https://git.gnexus.space/git/root/gnexus-tasks.git)
  • Stack: docker compose — db (postgres:17-alpine, healthy), api (FastAPI, healthy, migrations run at container start), web (nginx, SPA + proxy /api/, /auth/, /mcp/ → api)
  • Public URL: https://tasks.gnexus.space (TLS terminates on internal-proxy-vps .226, separate LE cert valid until 2026-12-20; upstream http://192.168.1.179:8135)
  • WEB_PORT: 8135 (container web 0.0.0.0:8135→80)
  • Config: /srv/gntodo/.env — GAUTH_BASE_URL=https://auth.gnexus.space, GAUTH_REDIRECT_URI=https://tasks.gnexus.space/auth/callback, OLLAMA_BASE_URL=http://192.168.1.130:11434, OLLAMA_MODEL=qwen3.5:2b-q4_K_M (model confirmed present on .130), random SESSION_SECRET/MCP_TOKEN/POSTGRES_PASSWORD
  • SSO: GAUTH_CLIENT_ID/GAUTH_CLIENT_SECRET still change-me — pending client registration in auth.gnexus.space by owner; login flow will fail until then (deploy.md step 3)
  • Deploy notes: built by ayame via peer task (docker compose up -d --build; build takes several minutes on 2 vCPU — first attempt hit a 20s command timeout, second run completed); docker requires sudo (ubuntu user not in docker group)
  • Verified 2026-09-21 (external): https://tasks.gnexus.space/ → 200 text/html (SPA), /api/health → {"status":"ok"}, /auth/login → 200 GNexus Auth sign-in page

Deploy notes (navi ayame)

  • Docker 29.1.3 was preinstalled; docker compose plugin v5.5.1 installed manually to /usr/local/lib/docker/cli-plugins/docker-compose before install.sh
  • install.sh ran via echo <sudo-password> | sudo -S bash deploy/install.sh (idempotent)
  • install.sh generated .swarm-key as root (600) — chown to ubuntu before copying the real hive key over scp
  • OLLAMA_APIKEY / EMBEDDING* appended to .env from the hive host's .env (secrets not documented here)
  • First boot crashed once with relation "sessions" does not exist (DB schema race during restart); subsequent boots clean

Listening ports (TCP, verified 2026-09-21)

  • 22 — sshd
  • 8135 — gntodo web container (docker, 0.0.0.0)
  • 8099 — navi-server (ayame)
  • 5432 — navi-postgres docker (localhost only)

Notes

  • Known non-critical warnings (same as other swarm instances): MCP server 'navi_ui' connect failed (anyio CancelledError), tool_loader.file_error for gmail.py (ModuleNotFoundError: html2text)
  • gntodo update procedure: cd /srv/gntodo && git pull --ff-only && docker compose up -d --build (migrations run automatically at api start); backups: docker compose exec db pg_dump -U gntodo gntodo + named volume gntodo_attachments (see repo docs/deploy.md)