# Розгортання

Neotask може працювати де завгодно, від вашого ноутбука до кластера Kubernetes. Виберіть метод розгортання, що відповідає вашим потребам.

## Локальне встановлення

Найпростіший спосіб розпочати. Встановіть Neotask безпосередньо на macOS, Linux або Windows (через WSL2). Gateway працює як фонова служба, керована launchd (macOS) або systemd (Linux).

**Вимоги:** Node.js 22+

**Що ви отримуєте:**
- Gateway, що працює як фонова служба
- Автоматичний запуск при завантаженні системи
- Застосунок-компаньйон для macOS (на macOS)
- Всі інструменти CLI

## Docker

Запускайте Gateway у Docker-контейнері з постійними томами конфігурації та робочого простору. Ідеально для розгортань на VPS або коли вам потрібна ізоляція від хост-системи.

**Функції:**
- Готові образи на основі Node 22 (Debian)
- Опційний Chromium + Xvfb для автоматизації браузера (додає ~300 МБ)
- Налаштування Docker Compose з постійними томами
- Кінцева точка перевірки стану на `/health`
- Виконується від імені непривілейованого користувача `node`
- Підтримка sandbox для агентів (Docker-in-Docker для ізольованого виконання)

**Постійний стан:**
- Конфігурація: `~/.neotask/neotask.json`
- Робочий простір: `~/.neotask/workspace/`
- Сесії: `~/.neotask/agents/*/sessions/`
- Стан каналів: `~/.neotask/whatsapp/` тощо

## Kubernetes

Розгортайте в Kubernetes за допомогою шаблону StatefulSet для постійного сховища. Доступні підтримувані спільнотою Helm-чарти.

**Типове налаштування:**
- **StatefulSet** для Gateway (постійні сесії та конфігурація)
- **ConfigMap** для конфігурації `neotask.json`
- **Secret** для токенів та API-ключів
- **PersistentVolumeClaim** для даних сесій та робочого простору
- **Service** (ClusterIP або LoadBalancer) для доступу через WebSocket

## Fly.io

Розгортання однією командою на Fly.io з постійними томами та автоматичним HTTPS.

**Функції:**
- x86-ВМ з конфігурованою оперативною пам'яттю (за замовчуванням 2048 МБ)
- Постійний том `/data` для конфігурації та сесій
- Автоматичне завершення TLS
- SSH-доступ для конфігурації
- Підтримка вебхуків через ngrok (опційно)

## Hetzner VPS

Запускайте на виділеному VPS Hetzner з Docker Compose. Повна підтримка інфраструктури як коду з модулями Terraform від спільноти.

**Налаштування включає:**
- Конфігурацію Docker Compose
- Постійні директорії для конфігурації, робочого простору та стану каналів
- Власний Dockerfile для вбудовування необхідних бінарних файлів
- Налаштування брандмауера та посилення безпеки

## Render

Розгортання на основі Blueprint на Render з автоматичними збірками та постійним диском 1 ГБ.

## GCP Compute Engine

Розгортання на основі Docker у Google Cloud з постійним диском та автоматизацією запуску.

## Podman

Безкореневе виконання контейнерів з підтримкою Podman та системного Quadlet. Ідеально для середовищ, де доступ до демону Docker обмежений.

## Вибір способу розгортання

| Потреба | Рекомендація |
|------|-------------|
| Просто спробувати | Локальне встановлення |
| Особисте використання на Mac | Локально + застосунок-компаньйон для macOS |
| Завжди увімкнений сервер | Docker на VPS (Hetzner, DigitalOcean) |
| Продуктивне середовище з масштабуванням | Kubernetes |
| Швидке хмарне розгортання | Fly.io або Render |
| Безкореневі контейнери | Podman |

## Віддалений доступ

За замовчуванням Gateway слухає лише на localhost (127.0.0.1). Для віддаленого доступу:

- **Tailscale**, VPN-мережа типу «сітка» з автоматичним DNS. Gateway може прив'язатися до вашої Tailnet для безпечного доступу з будь-якого місця. Tailscale Serve може надавати доступ до панелі з HTTPS.
- **SSH-тунель**, Перенаправте порт Gateway через SSH для безпечного віддаленого доступу без відкриття портів.
- **Прив'язка до локальної мережі**, Прив'яжіться до вашої локальної мережі для доступу з інших пристроїв у тій самій мережі. Автоматичне виявлення через Bonjour/mDNS.

Деталі конфігурації дивіться в розділі [Gateway](gateway.md).