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

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 para detalles de configuracion.