Deployment
Neotask dapat berjalan di mana saja, dari laptop Anda hingga kluster Kubernetes. Pilih metode deployment yang sesuai dengan kebutuhan Anda.
Instalasi Lokal
Cara paling sederhana untuk memulai. Instal Neotask langsung di macOS, Linux, atau Windows (melalui WSL2). Gateway berjalan sebagai layanan latar belakang yang dikelola oleh launchd (macOS) atau systemd (Linux).
Persyaratan: Node.js 22+
Yang Anda dapatkan:
- Gateway berjalan sebagai layanan latar belakang
- Startup otomatis saat boot
- Aplikasi pendamping macOS (di macOS)
- Semua alat CLI
Docker
Jalankan Gateway dalam kontainer Docker dengan volume konfigurasi dan workspace persisten. Ideal untuk deployment VPS atau ketika Anda ingin isolasi dari sistem host Anda.
Fitur:
- Gambar yang sudah dibangun berdasarkan Node 22 (Debian)
- Chromium + Xvfb opsional untuk otomasi browser (menambahkan ~300MB)
- Pengaturan Docker Compose dengan volume persisten
- Endpoint health check di
/health - Berjalan sebagai pengguna
nodenon-root - Dukungan sandbox agen (Docker-in-Docker untuk eksekusi terisolasi)
Status Persisten:
- Konfigurasi:
~/.neotask/neotask.json - Workspace:
~/.neotask/workspace/ - Sesi:
~/.neotask/agents/*/sessions/ - Status channel:
~/.neotask/whatsapp/, dll.
Kubernetes
Deploy ke Kubernetes menggunakan pola StatefulSet untuk penyimpanan persisten. Helm chart yang dipelihara komunitas tersedia.
Pengaturan tipikal:
- StatefulSet untuk Gateway (sesi dan konfigurasi persisten)
- ConfigMap untuk konfigurasi
neotask.json - Secret untuk token dan kunci API
- PersistentVolumeClaim untuk data sesi dan workspace
- Service (ClusterIP atau LoadBalancer) untuk akses WebSocket
Fly.io
Deployment satu perintah ke Fly.io dengan volume persisten dan HTTPS otomatis.
Fitur:
- VM x86 dengan RAM yang dapat dikonfigurasi (default 2048MB)
- Volume
/datapersisten untuk konfigurasi dan sesi - Terminasi TLS otomatis
- Akses SSH untuk konfigurasi
- Dukungan webhook via ngrok (opsional)
Hetzner VPS
Jalankan di VPS Hetzner khusus dengan Docker Compose. Dukungan penuh infrastructure-as-code dengan modul Terraform komunitas.
Pengaturan meliputi:
- Konfigurasi Docker Compose
- Direktori persisten untuk konfigurasi, workspace, dan status channel
- Dockerfile kustom untuk memanggang binari yang diperlukan
- Penguatan firewall dan keamanan
Render
Deployment berbasis Blueprint di Render dengan build otomatis dan disk persisten 1GB.
GCP Compute Engine
Deployment berbasis Docker di Google Cloud dengan disk persisten dan otomasi startup.
Podman
Eksekusi kontainer tanpa root dengan Podman dan dukungan systemd Quadlet. Ideal untuk lingkungan di mana akses daemon Docker dibatasi.
Memilih Deployment
| Kebutuhan | Rekomendasi |
|---|---|
| Hanya mencoba | Instalasi lokal |
| Penggunaan pribadi di Mac Anda | Lokal + aplikasi pendamping macOS |
| Server yang selalu aktif | Docker di VPS (Hetzner, DigitalOcean) |
| Produksi dengan skalabilitas | Kubernetes |
| Deploy cloud cepat | Fly.io atau Render |
| Kontainer tanpa root | Podman |
Akses Jarak Jauh
Secara default, Gateway hanya mendengarkan pada localhost (127.0.0.1). Untuk akses jarak jauh:
- Tailscale, Jaringan mesh VPN dengan DNS otomatis. Gateway dapat mengikat ke Tailnet Anda untuk akses aman dari mana saja. Tailscale Serve dapat mengekspos dasbor dengan HTTPS.
- SSH Tunnel, Teruskan port Gateway melalui SSH untuk akses jarak jauh yang aman tanpa mengekspos port.
- LAN Bind, Ikat ke jaringan lokal Anda untuk akses dari perangkat lain di jaringan yang sama. Penemuan otomatis melalui Bonjour/mDNS.
Lihat Gateway untuk detail konfigurasi.