---
- 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