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 bölümüne bakın.