---
- id: external-openvpn-server
  name: External OpenVPN Server
  type: vpn
  status: active
  host: external-vps
  domains: []
  ports: []
  criticality: high
  docs: ../10-systems/traffic-routes/public-gnexus-space-to-internal-nginx.md
  runbook: ''
  last_reviewed: 2026-05-09
  source_of_truth: owner-confirmed
- id: internal-openvpn-client
  name: Internal OpenVPN Client
  type: vpn-client
  status: active
  host: internal-proxy-vps
  domains: []
  ports: []
  criticality: high
  docs: ../10-systems/servers/internal-proxy-vps.md
  runbook: ''
  last_reviewed: 2026-05-09
  source_of_truth: owner-confirmed
- id: internal-nginx-proxy
  name: Internal nginx Reverse Proxy
  type: reverse-proxy
  status: active
  host: internal-proxy-vps
  domains:
  - gnexus-space
  - git-gnexus-space
  - jellyfin-gnexus-space
  - lytvak-gnexus-space
  - minecraft-gnexus-space
  - auth-gnexus-space
  - cloud-gnexus-space
  - files-gnexus-space
  - navi-gnexus-space
  - transmission-gnexus-space
  - bugtrail-gnexus-space
  ports:
  - 80
  - 443
  nginx:
    available_sites_not_confirmed_enabled:
    - anicusi.gnexus.space
    - cats.gnexus.space
    - fdroid.gnexus.space
    - ferumina.gnexus.space
    - lytvak.gnexus.space
    - mail.gnexus.space
    - minecraft.gnexus.space
    - 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
      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
    - domain: gnexus.space
      enabled: true
      upstream: http://192.168.1.151
    - domain: jellyfin.gnexus.space
      enabled: true
      upstream: http://192.168.1.153:8096
    - 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
      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
    - domain: minecraft.gnexus.space
      enabled: false
      upstream: tcp://192.168.1.218:25565
  criticality: high
  docs: ../10-systems/servers/internal-proxy-vps.md
  runbook: ''
  last_reviewed: '2026-09-18'
  source_of_truth: ssh-nginx-and-owner-confirmed
- id: smart-home-platform
  name: Smart Home Platform
  type: smart-home
  status: active
  host: smart-home-server
  domains: []
  ports:
  - 80
  - 443
  criticality: high
  network_context:
  - home-lan
  - home-iot-lan
  controlled_device_scope:
  - smart-home-devices
  - iot-devices
  stack:
    backend: PHP 8.3 FPM
    web_server: nginx
    database: MySQL
    framework: Fury custom PHP microframework
    frontend: JavaScript/SCSS build with gulp/esbuild/sass
    device_firmware: ESP8266/ESP32 firmware using sh_core_esp8266
  application_paths:
    repository: /home/shome/smart-home-server
    backend_root: /home/shome/smart-home-server/server
    webclient_root: /home/shome/smart-home-server/webclient
    devices_root: /home/shome/smart-home-server/devices
    docs_root: /home/shome/smart-home-server/docs
  architecture_policy:
    automation_logic: ControlScripts are the only intended place for device-control
      business logic.
    device_control: Devices and web clients should not directly control other devices
      through external REST APIs.
  docs: ../10-systems/automations/smart-home-overview.md
  runbook: ''
  last_reviewed: 2026-05-10
  source_of_truth: owner-described-and-ssh-host
- id: gitbucket
  name: GitBucket
  type: git-hosting
  status: active
  host: gitbucket
  domains:
  - git-gnexus-space
  ports:
  - 80
  criticality: high
  public_url: https://git.gnexus.space/
  internal_upstream: http://192.168.1.156
  repository_owner: root
  repository_count_observed: 65
  api:
    base_url: https://git.gnexus.space/api/v3
    compatibility: GitHub-compatible API surface
    auth: personal-access-token
    credential_reference: owner-managed
  docs: ../10-systems/applications/gitbucket.md
  runbook: ''
  last_reviewed: 2026-05-10
  source_of_truth: gitbucket-api-and-nginx-proxy
- id: mardisops
  criticality: medium
  docs: ../10-systems/bots/mardisopsbot.md
  host: tgbots-vm
  last_reviewed: '2026-09-10'
  name: MardisOpsBot
  ports: []
  runbook: ''
  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
- id: gntranscribe
  criticality: medium
  description: 'Telegram bot @gntranscribe_bot: forwards voice/audio/video to whisper-server
    (bserv-host 192.168.1.130:8008) and returns transcripts. asyncio queue (max 20),
    single worker, optional chat_id whitelist via ALLOWED_CHAT_IDS in .env, commands
    /start /help /id /status. python-telegram-bot 21.10.'
  docs: ../10-systems/bots/gntranscribe.md
  host: tgbots-vm
  last_reviewed: '2026-09-20'
  name: GNtranscribe
  path: /home/ubuntu/bots/GNtranscribe
  ports: []
  runbook: ''
  source_of_truth: live_system
  status: active
  systemd_unit: gntranscribe.service
  type: telegram-bot
  upstream: http://192.168.1.130:8008/inference
- id: gntodo
  criticality: medium
  deployed_at: '2026-09-21'
  description: 'GNexus Tasks (gntodo): personal task manager with projects, recurring
    tasks, XP/garden rewards. Docker compose stack (postgres:17 + FastAPI api + nginx
    web SPA) in /srv/gntodo on gntasks host. SSO via gnexus-auth (OAuth + signed webhook),
    per-user MCP tokens (Settings → MCP tokens), multi-tenant since ac8aefb (ТЗ 0.34).
    MCP endpoint https://tasks.gnexus.space/mcp/ (streamable HTTP, Bearer per-user
    token). Browser extension (MV3, ТЗ 0.42+): ZIP built inside web image (frontend/Dockerfile
    multi-stage), served at https://tasks.gnexus.space/extension/gntodo-extension.zip,
    instruction page /extension. Deploy: cd /srv/gntodo && sudo docker compose up
    -d --build (repo owned by root, sudo -S with owner password). Daily automated
    backups since 2026-10-09: /usr/local/bin/gntodo-backup.sh (pg_dump + attachments
    volume tar), root cron 30 3 * * * (UTC), rotation keeps newest 10, log /var/log/gntodo-backup.log.'
  docs: ../10-systems/hosts/gntasks.md
  domains:
  - tasks-gnexus-space
  health_endpoint: /api/health
  host: gntasks
  internal_upstream: http://192.168.1.179:8135
  last_reviewed: '2026-10-09'
  name: GNexus Tasks (gntodo)
  ports:
  - 8135
  public_url: https://tasks.gnexus.space/
  repository: https://git.gnexus.space/git/root/gnexus-tasks.git
  source_of_truth: ssh-host-and-live-verified
  status: active
  tls: terminates on internal-proxy-vps (.226), separate Let's Encrypt certificate
    CN=tasks.gnexus.space (expires 2026-12-20)
  type: web-app
- id: tgclient-mcp
  active_services:
  - tgclient-mcp-docker-compose
  criticality: medium
  description: 'tgclient-mcp: multi-account Telegram user-client (Telethon) + MCP
    server (/mcp, streamable HTTP, Bearer mcp_*) + SPA admin (SSO). Docker compose
    single service tgclient, port 8710->8000, volume data:/data (SQLite WAL). Accounts:
    id 1 sukhodolskiy, id 2 Navi. Big files: download_media returns base64 and is
    capped at 20 MiB; disk-side download is a manual container-script workaround until
    gntodo #543/#544 are implemented.'
  docs: ../10-systems/applications/tgclient-mcp.md
  domains:
  - tgclientmcp-gnexus-space
  health_endpoint: /api/v1/health
  host: tgclientmcp
  internal_upstream: http://192.168.1.171:8710
  last_reviewed: '2026-11-14'
  name: tgclient-mcp
  owner: gmikcon
  ports:
  - 8710
  purpose: MCP interface to the owner's Telegram accounts for Navi agents
  source_of_truth: ssh-host-and-live-verified
  status: active
  type: telegram-client-mcp
