# Implantacao

Neotask pode rodar em qualquer lugar -- do seu laptop a um cluster Kubernetes. Escolha o metodo de implantacao que se adapta as suas necessidades.

## Instalacao Local

A forma mais simples de comecar. Instale Neotask diretamente no macOS, Linux ou Windows (via WSL2). O Gateway roda como um servico em segundo plano gerenciado por launchd (macOS) ou systemd (Linux).

**Requisitos:** Node.js 22+

**O que voce recebe:**
- Gateway rodando como servico em segundo plano
- Inicializacao automatica no boot
- App companion macOS (no macOS)
- Todas as ferramentas CLI

## Docker

Execute o Gateway em um container Docker com volumes persistentes de configuracao e workspace. Ideal para implantacoes em VPS ou quando voce quer isolamento do sistema host.

**Recursos:**
- Imagens pre-construidas baseadas em Node 22 (Debian)
- Chromium + Xvfb opcional para automacao de navegador (adiciona ~300MB)
- Setup com Docker Compose com volumes persistentes
- Endpoint de health check em `/health`
- Executa como usuario `node` nao-root
- Suporte a sandbox de agente (Docker-in-Docker para execucao isolada)

**Estado Persistente:**
- Configuracao: `~/.neotask/neotask.json`
- Workspace: `~/.neotask/workspace/`
- Sessoes: `~/.neotask/agents/*/sessions/`
- Estado de canal: `~/.neotask/whatsapp/`, etc.

## Kubernetes

Implante no Kubernetes usando o padrao StatefulSet para armazenamento persistente. Helm charts mantidos pela comunidade estao disponiveis.

**Setup tipico:**
- **StatefulSet** para o Gateway (sessoes e configuracao persistentes)
- **ConfigMap** para configuracao `neotask.json`
- **Secret** para tokens e API keys
- **PersistentVolumeClaim** para dados de sessao e workspace
- **Service** (ClusterIP ou LoadBalancer) para acesso WebSocket

## Fly.io

Implantacao com um comando no Fly.io com volumes persistentes e HTTPS automatico.

**Recursos:**
- VM x86 com RAM configuravel (padrao 2048MB)
- Volume persistente `/data` para configuracao e sessoes
- Terminacao TLS automatica
- Acesso SSH para configuracao
- Suporte a webhook via ngrok (opcional)

## Hetzner VPS

Execute em um VPS Hetzner dedicado com Docker Compose. Suporte completo a infraestrutura como codigo com modulos Terraform da comunidade.

**O setup inclui:**
- Configuracao Docker Compose
- Diretorios persistentes para configuracao, workspace e estado de canal
- Dockerfile personalizado para incluir binarios necessarios
- Firewall e hardening de seguranca

## Render

Implantacao baseada em Blueprint no Render com builds automaticos e disco persistente de 1GB.

## GCP Compute Engine

Implantacao baseada em Docker no Google Cloud com disco persistente e automacao de inicializacao.

## Podman

Execucao de containers rootless com Podman e suporte a Quadlet systemd. Ideal para ambientes onde o acesso ao daemon Docker e restrito.

## Escolhendo uma Implantacao

| Necessidade | Recomendado |
|-------------|-------------|
| Apenas experimentando | Instalacao local |
| Uso pessoal no seu Mac | Local + app companion macOS |
| Servidor sempre ativo | Docker em VPS (Hetzner, DigitalOcean) |
| Producao com escalabilidade | Kubernetes |
| Deploy rapido na nuvem | Fly.io ou Render |
| Containers rootless | Podman |

## Acesso Remoto

Por padrao, o Gateway escuta apenas no localhost (127.0.0.1). Para acesso remoto:

- **Tailscale** -- Rede mesh VPN com DNS automatico. O Gateway pode se vincular ao seu Tailnet para acesso seguro de qualquer lugar. Tailscale Serve pode expor o dashboard com HTTPS.
- **Tunel SSH** -- Encaminhe a porta do Gateway atraves de SSH para acesso remoto seguro sem expor portas.
- **Vinculacao LAN** -- Vincule a sua rede local para acesso de outros dispositivos na mesma rede. Descoberta automatica via Bonjour/mDNS.

Veja [Gateway](gateway.md) para detalhes de configuracao.