diff --git a/10-systems/hosts/bugtrail.md b/10-systems/hosts/bugtrail.md index cdf4739..bca060e 100644 --- a/10-systems/hosts/bugtrail.md +++ b/10-systems/hosts/bugtrail.md @@ -2,11 +2,11 @@ title: VPS bugtrail type: host ip: 192.168.1.177 -purpose: Navi agent instance (navi-1, tsukiko) in home LAN +purpose: Navi agent instance (tsukiko) + BugTrail web service in home LAN owner: gmikcon status: active confidence: 100 -last_reviewed: 2026-09-17 +last_reviewed: 2026-09-18 review_interval: 90d source_of_truth: ssh-host-and-owner-confirmed --- @@ -14,9 +14,11 @@ # VPS bugtrail ## Overview -Home LAN VPS (KVM/QEMU VM), reported by the owner on 2026-09-17. On -2026-09-17 the navi-1 agent instance **tsukiko** was deployed here from the -`deploy` branch of https://git.gnexus.space/git/root/navi-1.git. +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) @@ -27,6 +29,7 @@ - **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 @@ -44,20 +47,34 @@ `echo | 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 (postgres container attached) +- `docker0` UP — 172.17.0.1/16 (navi-postgres attached); bugtrail compose network `bugtrail_default` -## Listening ports (TCP, verified 2026-09-17) +## 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) +- 5432 — postgres via docker-proxy (127.0.0.1 only, navi-postgres) -## Running services (2026-09-17) +## Running services (2026-09-18) - navi.service — navi-server (tsukiko instance) -- docker + containerd running, postgres container for navi +- docker compose stack `bugtrail`: postgres + server + caddy (restart: unless-stopped) - Standard Ubuntu daemons: cron, rsyslog, snapd, systemd-* suite ## Notes diff --git a/40-inventory/domains.yml b/40-inventory/domains.yml index b6d2f09..ae9610c 100644 --- a/40-inventory/domains.yml +++ b/40-inventory/domains.yml @@ -1,4 +1,3 @@ -# Domains and subdomains. --- - id: gnexus-space fqdn: gnexus.space @@ -6,126 +5,129 @@ registrar: OVHcloud dns_provider: OVHcloud points_to: - - external-vps + - external-vps used_by: - - internal-nginx-proxy + - internal-nginx-proxy docs: ../10-systems/domains/gnexus.space.md last_reviewed: 2026-05-09 source_of_truth: owner-confirmed - - id: git-gnexus-space fqdn: git.gnexus.space status: active registrar: OVHcloud dns_provider: OVHcloud points_to: - - external-vps + - external-vps used_by: - - internal-nginx-proxy + - internal-nginx-proxy docs: ../10-systems/domains/gnexus.space.md last_reviewed: 2026-05-09 source_of_truth: owner-confirmed - - id: jellyfin-gnexus-space fqdn: jellyfin.gnexus.space status: active registrar: OVHcloud dns_provider: OVHcloud points_to: - - external-vps + - external-vps used_by: - - internal-nginx-proxy + - internal-nginx-proxy docs: ../10-systems/domains/gnexus.space.md last_reviewed: 2026-05-09 source_of_truth: owner-confirmed - - id: lytvak-gnexus-space fqdn: lytvak.gnexus.space status: active registrar: OVHcloud dns_provider: OVHcloud points_to: - - external-vps + - external-vps used_by: - - internal-nginx-proxy + - internal-nginx-proxy docs: ../10-systems/domains/gnexus.space.md last_reviewed: 2026-05-09 source_of_truth: owner-confirmed - - id: minecraft-gnexus-space fqdn: minecraft.gnexus.space status: active registrar: OVHcloud dns_provider: OVHcloud points_to: - - external-vps + - external-vps used_by: - - internal-nginx-proxy + - internal-nginx-proxy docs: ../10-systems/domains/gnexus.space.md last_reviewed: 2026-05-09 source_of_truth: owner-confirmed - - id: auth-gnexus-space fqdn: auth.gnexus.space status: active registrar: OVHcloud dns_provider: OVHcloud points_to: - - external-vps + - external-vps used_by: - - internal-nginx-proxy + - internal-nginx-proxy docs: ../10-systems/domains/gnexus.space.md last_reviewed: 2026-05-09 source_of_truth: owner-confirmed - - id: cloud-gnexus-space fqdn: cloud.gnexus.space status: active registrar: OVHcloud dns_provider: OVHcloud points_to: - - external-vps + - external-vps used_by: - - internal-nginx-proxy + - internal-nginx-proxy docs: ../10-systems/domains/gnexus.space.md last_reviewed: 2026-05-09 source_of_truth: owner-confirmed - - id: files-gnexus-space fqdn: files.gnexus.space status: active registrar: OVHcloud dns_provider: OVHcloud points_to: - - external-vps + - external-vps used_by: - - internal-nginx-proxy + - internal-nginx-proxy docs: ../10-systems/domains/gnexus.space.md last_reviewed: 2026-05-09 source_of_truth: owner-confirmed - - id: navi-gnexus-space fqdn: navi.gnexus.space status: active registrar: OVHcloud dns_provider: OVHcloud points_to: - - external-vps + - external-vps used_by: - - internal-nginx-proxy + - internal-nginx-proxy docs: ../10-systems/domains/gnexus.space.md last_reviewed: 2026-05-09 source_of_truth: owner-confirmed - - id: transmission-gnexus-space fqdn: transmission.gnexus.space status: active registrar: OVHcloud dns_provider: OVHcloud points_to: - - external-vps + - external-vps used_by: - - internal-nginx-proxy + - internal-nginx-proxy docs: ../10-systems/domains/gnexus.space.md last_reviewed: 2026-05-09 source_of_truth: owner-confirmed +- id: bugtrail-gnexus-space + dns_provider: OVHcloud + docs: ../10-systems/domains/gnexus.space.md + fqdn: bugtrail.gnexus.space + last_reviewed: '2026-09-18' + points_to: + - external-vps + registrar: OVHcloud + source_of_truth: dns-verified + status: active + used_by: + - internal-nginx-proxy diff --git a/40-inventory/hosts.yml b/40-inventory/hosts.yml index dd5035b..2ebc50c 100644 --- a/40-inventory/hosts.yml +++ b/40-inventory/hosts.yml @@ -214,30 +214,36 @@ - docker.service - containerd.service - ssh.service + - bugtrail-docker-compose-stack addresses: lan: - 192.168.1.177 - 192.168.1.198 environment: home hostname: ubuntu - last_reviewed: '2026-09-17' + last_reviewed: '2026-09-18' listening_ports: tcp: - 22 - 53 + - 80 - 43225 - 8099 - 5432 name: bugtrail notes: 'Navi instance tsukiko (navi.service, port 8099, /home/bugtrail/navi-1, instance_id c9decfb7-39d1-4bf0-b3b3-c2c0d8d1e6fc) deployed 2026-09-17 from deploy branch. - Postgres in docker container on 127.0.0.1:5432. Hive announce to http://192.168.1.168:8087 - confirmed (announce_ok). Ollama backend via OLLAMA_HOST/OLLAMA_API_KEY in .env. - Secondary IP 192.168.1.198 purpose still unknown. Credentials: gnexus-creds secret - d654f5aa-412b-4fe0-87ad-89cc640375bb (SSH=sudo password).' + BugTrail web service deployed 2026-09-18: docker compose stack (postgres+server+caddy) + on port 80, repo /home/bugtrail/bugtrail (main@dfe9226), public https://bugtrail.gnexus.space + (TLS on internal proxy .226, separate LE cert). Postgres (navi) in docker container + on 127.0.0.1:5432. Hive announce to http://192.168.1.168:8087 confirmed (announce_ok). + Ollama backend via OLLAMA_HOST/OLLAMA_API_KEY in .env. Secondary IP 192.168.1.198 + purpose still unknown. User bugtrail NOT in docker group — docker via sudo. Node.js + v22.23.2 installed 2026-09-18 (NodeSource); make not installed. Credentials: gnexus-creds + secret d654f5aa-412b-4fe0-87ad-89cc640375bb (SSH=sudo password).' os: Ubuntu 22.04.5 LTS owner: gmikcon - purpose: Navi agent instance (navi-1, tsukiko) in home LAN + purpose: Navi agent instance (tsukiko) + BugTrail web service in home LAN source_of_truth: ssh-host-and-owner-confirmed status: active type: vps @@ -245,6 +251,7 @@ docs: ../10-systems/hosts/bugtrail.md roles: - navi-agent-instance + - bugtrail-web-service - id: mine active_services: - navi.service diff --git a/40-inventory/services.yml b/40-inventory/services.yml index 9058749..64f957d 100644 --- a/40-inventory/services.yml +++ b/40-inventory/services.yml @@ -39,20 +39,11 @@ - files-gnexus-space - navi-gnexus-space - transmission-gnexus-space + - bugtrail-gnexus-space ports: - 80 - 443 nginx: - version: nginx/1.18.0 - enabled_sites: - - auth.gnexus.space - - cloud.gnexus.space - - files.gnexus.space - - git.gnexus.space - - gnexus.space - - jellyfin.gnexus.space - - navi.gnexus.space - - transmission.gnexus.space available_sites_not_confirmed_enabled: - anicusi.gnexus.space - cats.gnexus.space @@ -64,41 +55,70 @@ - ollama.gnexus.space - sups.gnexus.space - topics.gnexus.space + enabled_sites: + - auth.gnexus.space + - bugtrail.gnexus.space + - cloud.gnexus.space + - creds.gnexus.space + - files.gnexus.space + - fuckjira.gnexus.space + - git.gnexus.space + - gnexus.space + - jellyfin.gnexus.space + - navi.gnexus.space + - transcribe-demo.gnexus.space + - transmission.gnexus.space + - vmk-marginator.gnexus.space proxy_mappings: - domain: auth.gnexus.space - upstream: http://192.168.1.167 enabled: true + upstream: http://192.168.1.167 + - domain: bugtrail.gnexus.space + enabled: true + upstream: http://192.168.1.177:80 - domain: cloud.gnexus.space + enabled: true upstream: http://192.168.1.152 + - domain: creds.gnexus.space enabled: true + upstream: http://192.168.1.173 - domain: files.gnexus.space + enabled: true upstream: http://192.168.1.157 + - domain: fuckjira.gnexus.space enabled: true + upstream: http://192.168.1.175:8080 - domain: git.gnexus.space + enabled: true upstream: http://192.168.1.156 - enabled: true - domain: gnexus.space + enabled: true upstream: http://192.168.1.151 - enabled: true - domain: jellyfin.gnexus.space + enabled: true upstream: http://192.168.1.153:8096 - enabled: true - domain: navi.gnexus.space + enabled: true upstream: http://192.168.1.168:8000 + - domain: transcribe-demo.gnexus.space enabled: true + upstream: http://192.168.1.75:5173 - domain: transmission.gnexus.space - upstream: http://192.168.1.154:3000 enabled: true + upstream: http://192.168.1.154:3000 + - domain: vmk-marginator.gnexus.space + enabled: true + upstream: http://192.168.1.178:8080 - domain: lytvak.gnexus.space + enabled: false upstream: http://192.168.1.167 - enabled: false - domain: minecraft.gnexus.space - upstream: tcp://192.168.1.218:25565 enabled: false + upstream: tcp://192.168.1.218:25565 criticality: high docs: ../10-systems/servers/internal-proxy-vps.md runbook: '' - last_reviewed: 2026-05-09 + last_reviewed: '2026-09-18' source_of_truth: ssh-nginx-and-owner-confirmed - id: smart-home-platform name: Smart Home Platform @@ -172,3 +192,27 @@ source_of_truth: live_system status: active type: telegram-bot +- id: bugtrail + criticality: medium + deployed_at: '2026-09-18' + description: 'Bug-report handoff service (tester → developer): page-annotation notes, + screenshots, FastAPI backend + Vue 3 panel + Chrome/Firefox MV3 extension. Docker + compose stack (postgres+server+caddy) in /home/bugtrail/bugtrail, health GET /api/healthz.' + docs: ../10-systems/hosts/bugtrail.md + domains: + - bugtrail-gnexus-space + health_endpoint: /api/healthz + host: bugtrail + internal_upstream: http://192.168.1.177:80 + last_reviewed: '2026-09-18' + name: BugTrail + ports: + - 80 + public_url: https://bugtrail.gnexus.space/ + repository: https://git.gnexus.space/git/root/bugtrail.git + runbook: '' + source_of_truth: ssh-host-and-live-verified + status: active + tls: terminates on internal-proxy-vps (.226), separate Let's Encrypt certificate + CN=bugtrail.gnexus.space (expires 2026-12-17) + type: web-app