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

title: VPS bugtrail type: host ip: 192.168.1.177 purpose: Navi agent instance (tsukiko) + BugTrail web service in home LAN owner: gmikcon status: active confidence: "100" last_reviewed: "2026-09-18" review_interval: 90d

source_of_truth: ssh-host-and-owner-confirmed

VPS bugtrail

Overview

Home LAN VPS (KVM/QEMU VM). Hosts the navi-1 agent instance tsukiko (deployed 2026-09-17 from the deploy branch of https://git.gnexus.space/git/root/navi-1.git) and the BugTrail web service (deployed 2026-09-18 from https://git.gnexus.space/git/root/bugtrail.git).

Technical Details

  • Local IP: 192.168.1.177 (primary)
  • Secondary IP: 192.168.1.198/24 on the same interface (metric 100, purpose unknown — clarify with owner)
  • OS: Ubuntu 22.04.5 LTS (Jammy Jellyfish)
  • Kernel: 5.15.0-191-generic
  • User: bugtrail
  • Hostname: ubuntu (verified via SSH 2026-09-17)
  • Credentials: gnexus-creds secret "VPS bugtrail SSH (192.168.1.177)" (id d654f5aa-412b-4fe0-87ad-89cc640375bb); sudo uses the same password
  • Platform: KVM/QEMU VM (MAC 52:54:00:38:86:8c), 2 vCPU, 3.8 GiB RAM, 31G LVM root disk
  • Note: user bugtrail is NOT in the docker group — docker commands require sudo
  • Instance name: tsukiko
  • Instance ID: c9decfb7-39d1-4bf0-b3b3-c2c0d8d1e6fc
  • Repo: /home/bugtrail/navi-1 (branch deploy, commit e276b1e)
  • Service: navi.service (systemd, enabled, restarts on failure)
  • Server port: 8099 (0.0.0.0), health endpoint http://127.0.0.1:8099/health
  • Postgres: docker container, 127.0.0.1:5432
  • Python: standalone CPython 3.12.14 at /home/bugtrail/navi-1/.python/
  • Swarm key: /home/bugtrail/navi-1/.swarm-key (mode 600; value not documented)
  • Hive: HIVE_URL=http://192.168.1.168:8087 — announce_ok confirmed in journalctl
  • Ollama backend: OLLAMA_HOST=https://ollama.com, model glm-5.3-flash:cloud, API key set in .env (value not documented)
  • Webclient/auth: NAVI_WEBCLIENT_ENABLED=false, NAVI_AUTH_ENABLED=false
  • Install note: deploy/install.sh calls bare sudo (no -S); run it as echo <sudo-password> | sudo -S bash deploy/install.sh over non-interactive SSH. The script is idempotent.

BugTrail service (deployed 2026-09-18)

  • Repo: https://git.gnexus.space/git/root/bugtrail.git → /home/bugtrail/bugtrail (main@dfe9226)
  • What it is: bug-report handoff service (tester → developer): page-annotation notes, screenshots, FastAPI backend + Vue 3 panel + Chrome/Firefox MV3 extension
  • Stack: docker compose (docker-compose.prod.yml): bugtrail-postgres-1 (postgres:16-alpine), bugtrail-server-1 (FastAPI, python:3.13-slim; alembic migrations auto-apply on container start), bugtrail-caddy-1 (caddy:2-alpine — static panel + reverse proxy /api → server:8000)
  • Public URL: https://bugtrail.gnexus.space — TLS terminates on internal proxy 192.168.1.226 with a SEPARATE Let's Encrypt certificate (CN=bugtrail.gnexus.space, expires 2026-12-17); caddy serves plain HTTP on port 80 (SITE_ADDRESS=:80)
  • Port: 80 (caddy via docker-proxy, all interfaces)
  • Health: GET /api/healthz → {"status":"ok"}
  • Config: .env next to docker-compose.prod.yml — POSTGRES_PASSWORD (48-hex, chmod 600, value not documented), HTTP_PORT=80, HTTPS_PORT=443, SITE_ADDRESS=:80
  • Restart policy: restart: unless-stopped on all three services (added 2026-09-18)
  • Data / backup points: docker volume bugtrail_postgres_data + ./data (uploaded screenshots)
  • Build notes: Node.js v22.23.2 installed via NodeSource (was absent on host); make is NOT installed — deploy steps were run manually: npm ci, build packages/extension + packages/web, sudo docker compose -f docker-compose.prod.yml up -d --build
  • Deployed: 2026-09-18 by navi (rei), verified end-to-end (healthz + panel via HTTPS through public entrypoint)

Network

  • enp1s0 UP — 192.168.1.177/24 (primary), 192.168.1.198/24 (secondary, metric 100), link-local fe80::5054:ff:fe38:868c/64
  • docker0 UP — 172.17.0.1/16 (navi-postgres attached); bugtrail compose network bugtrail_default

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

  • 22 — sshd (all interfaces)
  • 53 — systemd-resolved (localhost only)
  • 80 — bugtrail caddy via docker-proxy (all interfaces)
  • 43225 — containerd API (localhost only)
  • 8099 — navi-server (all interfaces)
  • 5432 — postgres via docker-proxy (127.0.0.1 only, navi-postgres)

Running services (2026-09-18)

  • navi.service — navi-server (tsukiko instance)
  • docker compose stack bugtrail: postgres + server + caddy (restart: unless-stopped)
  • Standard Ubuntu daemons: cron, rsyslog, snapd, systemd-* suite

Notes

  • Secondary IP .198 purpose still to be confirmed by the owner.
  • Known non-critical warnings in navi journal: MCP server 'navi_ui' connect failed (anyio CancelledError), tool_loader.file_error for gmail.py (ModuleNotFoundError: html2text), startup.embed_unavailable (embed backend 401 — embed.ok=false in /health). Core server and hive announce are healthy.
  • 2026-11-04 (rei, verified): after the mass ACPI shutdown of the home infra (04:07→09:54 UTC) the BugTrail stack did NOT come up immediately — docker daemon started later than the host; containers were created ~10:11 UTC, alembic migrations re-applied cleanly, healthz 200 (LAN + public) verified. GOTCHA: after a host reboot expect /api/healthz to return 502 (caddy up, FastAPI backend down) for ~15–20 min while docker daemon/containers start — wait before escalating; docker compose up -d is idempotent and safe.