# Despliegue

Neotask puede ejecutarse en cualquier lugar -- desde su laptop hasta un cluster de Kubernetes. Elija el metodo de despliegue que se ajuste a sus necesidades.

## Instalacion Local

La forma mas simple de comenzar. Instale Neotask directamente en macOS, Linux o Windows (via WSL2). El Gateway se ejecuta como un servicio en segundo plano gestionado por launchd (macOS) o systemd (Linux).

**Requisitos:** Node.js 22+

**Lo que obtiene:**
- Gateway ejecutandose como servicio en segundo plano
- Inicio automatico al arrancar
- Aplicacion companion de macOS (en macOS)
- Todas las herramientas CLI

## Docker

Ejecute el Gateway en un contenedor Docker con volumenes persistentes de configuracion y espacio de trabajo. Ideal para despliegues en VPS o cuando quiere aislamiento de su sistema host.

**Caracteristicas:**
- Imagenes pre-construidas basadas en Node 22 (Debian)
- Chromium + Xvfb opcional para automatizacion de navegador (agrega ~300MB)
- Configuracion con Docker Compose con volumenes persistentes
- Endpoint de health check en `/health`
- Se ejecuta como usuario `node` sin privilegios root
- Soporte de sandbox de agentes (Docker-in-Docker para ejecucion aislada)

**Estado Persistente:**
- Configuracion: `~/.neotask/neotask.json`
- Espacio de trabajo: `~/.neotask/workspace/`
- Sesiones: `~/.neotask/agents/*/sessions/`
- Estado de canales: `~/.neotask/whatsapp/`, etc.

## Kubernetes

Despliegue en Kubernetes usando el patron StatefulSet para almacenamiento persistente. Hay Helm charts mantenidos por la comunidad disponibles.

**Configuracion tipica:**
- **StatefulSet** para el Gateway (sesiones y configuracion persistentes)
- **ConfigMap** para la configuracion `neotask.json`
- **Secret** para tokens y claves API
- **PersistentVolumeClaim** para datos de sesion y espacio de trabajo
- **Service** (ClusterIP o LoadBalancer) para acceso WebSocket

## Fly.io

Despliegue de un solo comando a Fly.io con volumenes persistentes y HTTPS automatico.

**Caracteristicas:**
- VM x86 con RAM configurable (por defecto 2048MB)
- Volumen `/data` persistente para configuracion y sesiones
- Terminacion TLS automatica
- Acceso SSH para configuracion
- Soporte de webhooks via ngrok (opcional)

## Hetzner VPS

Ejecute en un VPS dedicado de Hetzner con Docker Compose. Soporte completo de infraestructura como codigo con modulos Terraform de la comunidad.

**La configuracion incluye:**
- Configuracion de Docker Compose
- Directorios persistentes para configuracion, espacio de trabajo y estado de canales
- Dockerfile personalizado para incluir binarios requeridos
- Firewall y endurecimiento de seguridad

## Render

Despliegue basado en blueprint en Render con compilaciones automaticas y disco persistente de 1GB.

## GCP Compute Engine

Despliegue basado en Docker en Google Cloud con disco persistente y automatizacion de inicio.

## Podman

Ejecucion de contenedores sin root con Podman y soporte de systemd Quadlet. Ideal para entornos donde el acceso al daemon Docker esta restringido.

## Eligiendo un Despliegue

| Necesidad | Recomendado |
|------|-------------|
| Solo probandolo | Instalacion local |
| Uso personal en su Mac | Local + aplicacion companion de macOS |
| Servidor siempre activo | Docker en VPS (Hetzner, DigitalOcean) |
| Produccion con escalado | Kubernetes |
| Despliegue rapido en la nube | Fly.io o Render |
| Contenedores sin root | Podman |

## Acceso Remoto

Por defecto, el Gateway solo escucha en localhost (127.0.0.1). Para acceso remoto:

- **Tailscale** -- Red mesh VPN con DNS automatico. El Gateway puede vincularse a su Tailnet para acceso seguro desde cualquier lugar. Tailscale Serve puede exponer el panel con HTTPS.
- **Tunel SSH** -- Reenviar el puerto del Gateway a traves de SSH para acceso remoto seguro sin exponer puertos.
- **Vinculacion LAN** -- Vincular a su red local para acceso desde otros dispositivos en la misma red. Descubrimiento automatico via Bonjour/mDNS.

Consulte [Gateway](gateway.md) para detalles de configuracion.