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

owner: gmikcon status: active last_reviewed: 2026-10-17 review_interval: 90d confidence: high

source_of_truth: ssh-host

gnsynapse

VM in home LAN dedicated to the Gnexus Synapse project — the centralized notification hub of the Gnexus ecosystem (see gntodo project "Gnexus Synapse", id 9).

Identity

  • Hostname: gnsynapse
  • IP: 192.168.1.172 (static, configured inside the guest)
  • Type: KVM/libvirt VM on hp-proliant-dl380-g6
  • MAC: 52:54:00:79:23:90
  • User: ubuntu (sudo with same password)
  • Credentials: gnexus-creds secret gnsynapse-ssh (SSH = sudo password)

Platform

  • OS: Ubuntu 22.04.5 LTS (Jammy Jellyfish)
  • Kernel: 5.15.0-198-generic
  • CPU: 2 vCPU (Intel Xeon X5650 @ 2.67GHz)
  • RAM: 2 GB
  • Disk: 15 GB LVM (/dev/mapper/ubuntu--vg-ubuntu--lv), ~47% used at provisioning
  • Timezone: Europe/Kyiv (set 2026-10-04 by navi rei, was Etc/UTC)

Network

Static configuration inside the guest via netplan (/etc/netplan/50-static.yaml, since 2026-10-17; before that /etc/netplan/50-cloud-init.yaml):

  • enp1s0: 192.168.1.172/24
  • Gateway: 192.168.1.1
  • DNS: 192.168.1.1, 1.1.1.1
  • dhcp4: no — no pfSense static mapping needed; the address survives reboots and is not part of any DHCP pool.
  • Cloud-init network configuration disabled (/etc/cloud/cloud.cfg.d/99-disable-network-config.cfg: network: {config: disabled}) — netplan-файл больше не перегенерируется при загрузке.

Services

  • ssh.service — listening port 22
  • docker.service + containerd.service — Gnexus Synapse stack (docker compose, /home/ubuntu/gnsynapse): containers api, worker, postgres, redis; host port 8013; repo root/gn-synapse on GitBucket. Details: 10-systems/services/gnexus-synapse.md.
  • hard-monitor.service — GHard Monitor agent (see Monitoring below)

Monitoring

Агент hard-monitor (GHard Monitor) установлен 2026-10-04 (navi rei):

  • Установка: /opt/hard-monitor (venv: psutil, requests), конфиг /opt/hard-monitor/.env — PANEL_URL=http://192.168.1.176:8000, SERVER_KEY=ghm_…, INTERVAL=30
  • systemd-юнит hard-monitor.service — enabled, active
  • На панели: сервер gnsynapse, id 46, статус online (флот 19/19)
  • Ключ сервера в доках не дублируется: лежит в /opt/hard-monitor/.env на самом хосте; при переустановке взять оттуда или перерегистрировать сервер на панели (DELETE + POST /api/v1/servers)
  • Нюанс свежей VM: нет пакета python3.10-venv — перед install.sh нужен apt-get update && apt-get install -y python3.10-venv

2026-10-17: блэкаут, возврат на .172 (navi rei)

  • Ночной блэкаут 2026-10-16/17: VM погашена владельцем, утром 2026-10-17 запущена заново. Netplan-статика на момент блэкаута ещё не была настроена (файл был cloud-init DHCP) — VM получила от pfSense временный адрес 192.168.1.29, старый .172 освободился.
  • Временные фиксы (утро): nginx-апстрим на internal-proxy (.183) → http://192.168.1.29:8013; TGCLIENT_SYNAPSE_URL на tgclient → http://192.168.1.29:8013; MCP-конфиг navi → http://192.168.1.29:8013/mcp.
  • Возврат (решение владельца, день 2026-10-17): netplan-статика 192.168.1.172/24 (gateway 192.168.1.1, DNS 192.168.1.1 + 1.1.1.1), cloud-init network config disabled, 50-cloud-init.yaml удалён, создан 50-static.yaml; все зависимые конфиги откатаны на .172:8013. Проверено: synapse public/direct 200, hard-panel gnexus-synapse up, MCP synapse connected.
  • Открытый пункт: Kea-резервация на pfSense (MAC 52:54:00:79:23:90 → .172) не требуется, пока в госте статика; при отказе от статики — добавить резервацию (нужен админ-доступ к pfSense).

Notes

  • Provisioned 2026-10-04 as the host for the new Synapse project; IP chosen from verified free range 192.168.1.170–180.
  • Docker bridge docker0 (172.17.0.1/16) present from default install.