# Развёртывание

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 для автоматизации браузера (добавляет ~300MB)
- Настройка 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.

**Особенности:**
- VM на x86 с настраиваемым объёмом RAM (по умолчанию 2048MB)
- Постоянный том `/data` для конфигурации и сессий
- Автоматическое завершение TLS
- SSH-доступ для настройки
- Поддержка вебхуков через ngrok (опционально)

## Hetzner VPS

Запуск на выделенном VPS Hetzner с Docker Compose. Полная поддержка инфраструктуры как кода с модулями Terraform от сообщества.

**Настройка включает:**
- Конфигурацию Docker Compose
- Постоянные директории для конфигурации, рабочего пространства и состояния каналов
- Пользовательский Dockerfile для включения необходимых бинарных файлов
- Настройку брандмауэра и защиту безопасности

## Render

Развёртывание на основе Blueprint на Render с автоматическими сборками и 1GB постоянного диска.

## GCP Compute Engine

Развёртывание на основе Docker в Google Cloud с постоянным диском и автоматизацией запуска.

## Podman

Безрутовое выполнение контейнеров с Podman и поддержкой systemd 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 для безопасного удалённого доступа без открытия портов.
- **Привязка к LAN**, привязка к локальной сети для доступа с других устройств в той же сети. Автоматическое обнаружение через Bonjour/mDNS.

Подробности конфигурации см. в разделе [Gateway](gateway.md).