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 para detalhes de configuracao.