# Подключение Hermes Desktop (Windows) к серверу

Общая схема:

    [Windows] --LAN--> [Сервер 192.168.1.44:9119]
    Hermes Desktop        Hermes Dashboard
                          (тот же агент, что в этом сеансе)

---

## 1. Что уже сделано на сервере

- Dashboard запущен на `0.0.0.0:9119` (слушает все интерфейсы)
- Basic auth включена: логин `admin`, пароль `agent`
- Dashboard **автоматически стартует при загрузке сервера** (systemd-сервис `hermes-dashboard.service`)
- При падении перезапускается автоматически через 10 секунд

Проверить статус можно с сервера:

    curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:9119/api/health
    # → 200

    systemctl status hermes-dashboard.service
    # → active (running)

---

## 2. Подключение из Hermes Desktop (Windows)

1. Открой Hermes Desktop на Windows
2. Нажми `Ctrl+K` (Cmd+K на Mac) — откроется палитра команд
3. Набери **Remote Gateway** и выбери `Connect to Remote Gateway...` (или найди в Settings → Gateway → Remote)
4. Введи данные:
   - **URL сервера:** `http://192.168.1.44:9119`
   - **Логин:** `admin`
   - **Пароль:** `agent`
5. После подключения в левой панели появится серверный профиль — можно выбирать его и общаться как обычно.

> Если Windows подключён через VPN или из другой подсети — IP может отличаться.
> Узнать текущий IP сервера: `hostname -I`

---

## 3. Управление сервисом (на сервере)

Сервис уже установлен и активен. Команды управления:

| Действие | Команда |
|----------|---------|
| Статус | `systemctl status hermes-dashboard.service` |
| Стоп | `systemctl stop hermes-dashboard.service` |
| Старт | `systemctl start hermes-dashboard.service` |
| Рестарт | `systemctl restart hermes-dashboard.service` |
| Отключить автозапуск | `systemctl disable hermes-dashboard.service` |
| Логи (свежие) | `journalctl -u hermes-dashboard.service -n 50` |
| Логи (хвост) | `journalctl -u hermes-dashboard.service -f` |

---

## 4. Безопасность

- Доступ к dashboard возможен из **любого устройства в той же LAN** (подсеть 192.168.1.0/24), кто знает логин/пароль
- За пределами LAN dashboard **недоступен** — сервер не торчит в интернет
- Пароль хранится в `/root/.hermes/config.yaml` — не свети этот файл
- Для доступа из интернета — облачный relay (Nous Portal) или VPN/SSH-туннель

---

## 5. Что если не работает

| Симптом | Решение |
|---------|---------|
| Desktop пишет "Connection refused" | Сервис не запущен → `systemctl start hermes-dashboard.service` |
| 401 Unauthorized | Неправильный логин или пароль — проверь в `config.yaml` секцию `basic_auth` |
| Desktop видит сервер, но не отвечает | `hermes doctor` на сервере — проверить модель и соединение |
| Нет соединения после ребута сервера | Сервис включён в автозапуск, проверь статус `systemctl status hermes-dashboard.service` |