---
owner: gmikcon
status: active
last_reviewed: 2026-11-04
review_interval: 90d
confidence: high
source_of_truth: ssh-host
reviewed_by: navi rei
---

# 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-202-generic (live 2026-11-04; в доках ранее 5.15.0-198)
- 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).

## 2026-11-04: блэкаут стенда, server_offline волна (navi rei)

- Триггер: Synapse envelope `9b290f76-37d9-4a47-987c-7c2fdca554f3` — hard-panel `server_offline`, server_id 46 (gnsynapse), silent_minutes 353, priority high. Часть массовой волны server_offline ×18 (09:58:45 UTC) после полного блэкаута стенда 04:05–09:54 UTC — выключено всё, включая хост панели (слепое окно мониторинга ~5 ч 49 м). Канонический отчёт: `workspace/incident_infra_blackout_2026-11-04.md` (repo navi-1).
- Хронология VM: последний пакет до провала ~04:05 UTC (silent 353 мин от 09:58:45); бут ~09:55 UTC (uptime 1261 с при проверке 10:16) — VM перезагрузилась вместе со стендом.
- Верификация 10:16 UTC: панель — gnsynapse **online**, last_seen 10:16:12 UTC, интервал 30 с; CPU 3.2%, RAM 41%, swap 0, load 0.17, диск `/` 71.1% (на 2026-10-04 при provisioning было ~47% — рост за месяц, наблюдение; алертов по диску нет). Docker-стек Synapse `api/worker/postgres/redis` — **Up 19 мин** (api/postgres/redis healthy) — поднялся сам после бута; `hard-monitor.service` возобновил репортинг сам, рестарт не потребовался.
- Сервисы панели: 8/8 up, gnexus-synapse [up] 24.8 ms (код 200).
- Вывод: последствий для данных и сервисов Synapse нет; вмешательство не потребовалось — всё самовосстановилось после возврата питания. Причина провала — питание стенда (см. канонический инцидент-файл; рекомендация внешнего зонда — там же, на решение владельца).

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