# Dağıtım

Neotask her yerde çalışabilir, dizüstü bilgisayarınızdan Kubernetes kümesine kadar. İhtiyaçlarınıza uyan dağıtım yöntemini seçin.

## Yerel Kurulum

Başlamanın en basit yolu. Neotask'ı doğrudan macOS, Linux veya Windows'a (WSL2 aracılığıyla) kurun. Gateway, launchd (macOS) veya systemd (Linux) tarafından yönetilen bir arka plan hizmeti olarak çalışır.

**Gereksinimler:** Node.js 22+

**Ne elde edersiniz:**
- Arka plan hizmeti olarak çalışan Gateway
- Önyüklemede otomatik başlatma
- macOS eşlik eden uygulaması (macOS'ta)
- Tüm CLI araçları

## Docker

Gateway'i, kalıcı yapılandırma ve çalışma alanı birimleriyle bir Docker konteynerinde çalıştırın. VPS dağıtımları veya ana bilgisayar sisteminizden yalıtım istediğinizde idealdir.

**Özellikler:**
- Node 22'ye (Debian) dayalı önceden oluşturulmuş görüntüler
- Tarayıcı otomasyonu için isteğe bağlı Chromium + Xvfb (~300 MB ekler)
- Kalıcı birimlerle Docker Compose kurulumu
- `/health` adresinde sağlık kontrol uç noktası
- Kök olmayan `node` kullanıcısı olarak çalışır
- Ajan sanal alan desteği (yalıtılmış yürütme için Docker-in-Docker)

**Kalıcı Durum:**
- Yapılandırma: `~/.neotask/neotask.json`
- Çalışma alanı: `~/.neotask/workspace/`
- Oturumlar: `~/.neotask/agents/*/sessions/`
- Kanal durumu: `~/.neotask/whatsapp/` vb.

## Kubernetes

Kalıcı depolama için StatefulSet kalıbını kullanarak Kubernetes'e dağıtın. Topluluk tarafından bakımı yapılan Helm grafikleri mevcuttur.

**Tipik kurulum:**
- Gateway için **StatefulSet** (kalıcı oturumlar ve yapılandırma)
- `neotask.json` yapılandırması için **ConfigMap**
- Token'lar ve API anahtarları için **Secret**
- Oturum verileri ve çalışma alanı için **PersistentVolumeClaim**
- WebSocket erişimi için **Service** (ClusterIP veya LoadBalancer)

## Fly.io

Kalıcı birimler ve otomatik HTTPS ile Fly.io'ya tek komutla dağıtım.

**Özellikler:**
- Yapılandırılabilir RAM'e (varsayılan 2048 MB) sahip x86 VM
- Yapılandırma ve oturumlar için kalıcı `/data` birimi
- Otomatik TLS sonlandırma
- Yapılandırma için SSH erişimi
- ngrok üzerinden webhook desteği (isteğe bağlı)

## Hetzner VPS

Docker Compose ile özel Hetzner VPS üzerinde çalıştırın. Topluluk Terraform modülleriyle tam altyapı-kod olarak destek.

**Kurulum şunları içerir:**
- Docker Compose yapılandırması
- Yapılandırma, çalışma alanı ve kanal durumu için kalıcı dizinler
- Gerekli ikilileri yerleştirmek için özel Dockerfile
- Güvenlik duvarı ve güvenlik sertleştirme

## Render

Otomatik derlemeler ve 1 GB kalıcı diskle Render üzerinde şema tabanlı dağıtım.

## GCP Compute Engine

Kalıcı disk ve başlatma otomasyonuyla Google Cloud üzerinde Docker tabanlı dağıtım.

## Podman

systemd Quadlet desteğiyle Podman kullanarak köksüz konteyner yürütme. Docker daemon erişiminin kısıtlandığı ortamlar için idealdir.

## Dağıtım Seçimi

| İhtiyaç | Önerilen |
|------|-------------|
| Sadece denemek | Yerel kurulum |
| Mac'inizde kişisel kullanım | Yerel + macOS eşlik eden uygulama |
| Her zaman açık sunucu | VPS'de Docker (Hetzner, DigitalOcean) |
| Ölçeklendirmeyle üretim | Kubernetes |
| Hızlı bulut dağıtımı | Fly.io veya Render |
| Köksüz konteynerler | Podman |

## Uzaktan Erişim

Varsayılan olarak Gateway yalnızca localhost (127.0.0.1) üzerinde dinler. Uzaktan erişim için:

- **Tailscale**, Otomatik DNS ile VPN ağ bağlantısı. Gateway, her yerden güvenli erişim için Tailnet'inize bağlanabilir. Tailscale Serve, gösterge panelini HTTPS ile açığa çıkarabilir.
- **SSH Tüneli**, Portları açmadan güvenli uzaktan erişim için Gateway portunu SSH üzerinden iletin.
- **LAN Bağlaması**, Aynı ağdaki diğer cihazlardan erişim için yerel ağınıza bağlanın. Bonjour/mDNS üzerinden otomatik keşif.

Yapılandırma ayrıntıları için [Gateway](gateway.md) bölümüne bakın.