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
Navi instance (deployed 2026-09-17)
- 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.