Deployment
Neotask kann ueberall laufen -- von Ihrem Laptop bis zu einem Kubernetes-Cluster. Waehlen Sie die Deployment-Methode, die Ihren Anforderungen entspricht.
Lokale Installation
Der einfachste Einstieg. Installieren Sie Neotask direkt auf macOS, Linux oder Windows (ueber WSL2). Das Gateway laeuft als Hintergrunddienst, verwaltet von launchd (macOS) oder systemd (Linux).
Anforderungen: Node.js 22+
Was Sie erhalten:
- Gateway als Hintergrunddienst
- Automatischer Start beim Hochfahren
- macOS-Begleit-App (auf macOS)
- Alle CLI-Tools
Docker
Betreiben Sie das Gateway in einem Docker-Container mit persistenten Config- und Workspace-Volumes. Ideal fuer VPS-Deployments oder wenn Sie Isolation von Ihrem Host-System wuenschen.
Funktionen:
- Vorgefertigte Images basierend auf Node 22 (Debian)
- Optionales Chromium + Xvfb fuer Browser-Automatisierung (fuegt ca. 300MB hinzu)
- Docker Compose-Setup mit persistenten Volumes
- Health-Check-Endpunkt unter
/health - Laeuft als Non-Root-Benutzer
node - Agent-Sandbox-Unterstuetzung (Docker-in-Docker fuer isolierte Ausfuehrung)
Persistenter Status:
- Konfiguration:
~/.neotask/neotask.json - Workspace:
~/.neotask/workspace/ - Sessions:
~/.neotask/agents/*/sessions/ - Channel-Status:
~/.neotask/whatsapp/usw.
Kubernetes
Deployment auf Kubernetes unter Verwendung des StatefulSet-Musters fuer persistenten Speicher. Community-gepflegte Helm-Charts sind verfuegbar.
Typisches Setup:
- StatefulSet fuer das Gateway (persistente Sessions und Konfiguration)
- ConfigMap fuer
neotask.json-Konfiguration - Secret fuer Tokens und API-Schluessel
- PersistentVolumeClaim fuer Session-Daten und Workspace
- Service (ClusterIP oder LoadBalancer) fuer WebSocket-Zugriff
Fly.io
Ein-Befehl-Deployment auf Fly.io mit persistenten Volumes und automatischem HTTPS.
Funktionen:
- x86-VM mit konfigurierbarem RAM (Standard 2048MB)
- Persistentes
/data-Volume fuer Konfiguration und Sessions - Automatische TLS-Terminierung
- SSH-Zugang fuer Konfiguration
- Webhook-Unterstuetzung ueber ngrok (optional)
Hetzner VPS
Betrieb auf einem dedizierten Hetzner VPS mit Docker Compose. Vollstaendige Infrastructure-as-Code-Unterstuetzung mit Community-Terraform-Modulen.
Setup beinhaltet:
- Docker Compose-Konfiguration
- Persistente Verzeichnisse fuer Konfiguration, Workspace und Channel-Status
- Benutzerdefiniertes Dockerfile fuer das Einbinden erforderlicher Binaerdateien
- Firewall- und Sicherheitshaertung
Render
Blueprint-basiertes Deployment auf Render mit automatischen Builds und 1GB persistentem Speicher.
GCP Compute Engine
Docker-basiertes Deployment auf Google Cloud mit persistentem Speicher und Startup-Automatisierung.
Podman
Rootless-Container-Ausfuehrung mit Podman und systemd-Quadlet-Unterstuetzung. Ideal fuer Umgebungen, in denen der Docker-Daemon-Zugriff eingeschraenkt ist.
Deployment-Auswahl
| Bedarf | Empfehlung |
|---|---|
| Ausprobieren | Lokale Installation |
| Persoenliche Nutzung auf dem Mac | Lokal + macOS-Begleit-App |
| Always-On-Server | Docker auf VPS (Hetzner, DigitalOcean) |
| Produktion mit Skalierung | Kubernetes |
| Schnelles Cloud-Deployment | Fly.io oder Render |
| Rootless-Container | Podman |
Remote-Zugriff
Standardmaessig hoert das Gateway nur auf localhost (127.0.0.1). Fuer Remote-Zugriff:
- Tailscale -- VPN-Mesh-Netzwerk mit automatischem DNS. Das Gateway kann an Ihr Tailnet gebunden werden fuer sicheren Zugriff von ueberall. Tailscale Serve kann das Dashboard mit HTTPS bereitstellen.
- SSH-Tunnel -- Den Gateway-Port ueber SSH weiterleiten fuer sicheren Remote-Zugriff ohne Ports freizugeben.
- LAN-Bindung -- An Ihr lokales Netzwerk binden fuer Zugriff von anderen Geraeten im selben Netzwerk. Automatische Erkennung ueber Bonjour/mDNS.
Siehe Gateway fuer Konfigurationsdetails.