# Deployment

Neotask कहीं भी run हो सकता है, आपके laptop से लेकर Kubernetes cluster तक। वह deployment method चुनें जो आपकी जरूरतों के अनुकूल हो।

## Local Installation

शुरू करने का सबसे simple तरीका। Neotask को directly macOS, Linux, या Windows (WSL2 के माध्यम से) पर install करें। Gateway एक background service के रूप में run होता है जिसे launchd (macOS) या systemd (Linux) द्वारा managed किया जाता है।

**Requirements:** Node.js 22+

**आपको क्या मिलता है:**
- Background service के रूप में Gateway running
- Boot पर Automatic startup
- macOS companion app (macOS पर)
- सभी CLI tools

## Docker

Persistent config और workspace volumes के साथ एक Docker container में Gateway run करें। VPS deployments के लिए या जब आप अपने host system से isolation चाहते हैं तो ideal।

**Features:**
- Node 22 (Debian) पर based Pre-built images
- Browser automation के लिए Optional Chromium + Xvfb (~300MB add करता है)
- Persistent volumes के साथ Docker Compose setup
- `/health` पर Health check endpoint
- Non-root `node` user के रूप में Run करता है
- Agent sandbox support (isolated execution के लिए Docker-in-Docker)

**Persistent State:**
- Configuration: `~/.neotask/neotask.json`
- Workspace: `~/.neotask/workspace/`
- Sessions: `~/.neotask/agents/*/sessions/`
- Channel state: `~/.neotask/whatsapp/`, आदि

## Kubernetes

Persistent storage के लिए StatefulSet pattern का उपयोग करके Kubernetes पर deploy करें। Community-maintained Helm charts उपलब्ध हैं।

**Typical setup:**
- **StatefulSet** Gateway के लिए (persistent sessions और config)
- **ConfigMap** `neotask.json` configuration के लिए
- **Secret** tokens और API keys के लिए
- **PersistentVolumeClaim** session data और workspace के लिए
- **Service** (ClusterIP या LoadBalancer) WebSocket access के लिए

## Fly.io

Persistent volumes और automatic HTTPS के साथ Fly.io पर one-command deployment।

**Features:**
- Configurable RAM के साथ x86 VM (default 2048MB)
- Config और sessions के लिए Persistent `/data` volume
- Automatic TLS termination
- Configuration के लिए SSH access
- ngrok के माध्यम से Webhook support (optional)

## Hetzner VPS

Docker Compose के साथ एक dedicated Hetzner VPS पर run करें। Community Terraform modules के साथ full infrastructure-as-code support।

**Setup includes:**
- Docker Compose configuration
- Config, workspace, और channel state के लिए persistent directories
- Required binaries bake करने के लिए Custom Dockerfile
- Firewall और security hardening

## Render

Automatic builds और 1GB persistent disk के साथ Render पर Blueprint-based deployment।

## GCP Compute Engine

Persistent disk और startup automation के साथ Google Cloud पर Docker-based deployment।

## Podman

Podman और systemd Quadlet support के साथ Rootless container execution। उन environments के लिए ideal जहां Docker daemon access restricted है।

## Deployment चुनना

| आवश्यकता | Recommended |
|------|-------------|
| बस try करना | Local install |
| अपने Mac पर personal use | Local + macOS companion app |
| Always-on server | Docker on VPS (Hetzner, DigitalOcean) |
| Scaling के साथ Production | Kubernetes |
| Quick cloud deploy | Fly.io या Render |
| Rootless containers | Podman |

## Remote Access

Default रूप से, Gateway केवल localhost (127.0.0.1) पर listen करता है। Remote access के लिए:

- **Tailscale**, Automatic DNS के साथ VPN mesh network। Gateway आपके Tailnet से bind हो सकता है कहीं से भी secure access के लिए। Tailscale Serve HTTPS के साथ dashboard expose कर सकता है।
- **SSH Tunnel**, Ports expose किए बिना secure remote access के लिए SSH के माध्यम से Gateway port forward करें।
- **LAN Bind**, Same network पर अन्य devices से access के लिए अपने local network से bind करें। Bonjour/mDNS के माध्यम से Automatic discovery।

Configuration details के लिए [Gateway](gateway.md) देखें।