Implementatie
Neotask kan overal draaien, van uw laptop tot een Kubernetes-cluster. Kies de implementatiemethode die bij uw behoeften past.
Lokale installatie
De eenvoudigste manier om te beginnen. Installeer Neotask rechtstreeks op macOS, Linux of Windows (via WSL2). De Gateway draait als een achtergrondservice beheerd door launchd (macOS) of systemd (Linux).
Vereisten: Node.js 22+
Wat u krijgt:
- Gateway als achtergrondservice
- Automatisch opstarten bij het opstarten
- macOS companion-app (op macOS)
- Alle CLI-tools
Docker
Voer de Gateway uit in een Docker-container met aanhoudende configuratie- en werkruimtevolumes. Ideaal voor VPS-implementaties of wanneer u isolatie van uw hostsysteem wilt.
Functies:
- Voorgemaakte images gebaseerd op Node 22 (Debian)
- Optionele Chromium + Xvfb voor browserautomatisering (voegt ~300 MB toe)
- Docker Compose-instelling met aanhoudende volumes
- Gezondheidscontrolepunt op
/health - Draait als niet-root
node-gebruiker - Ondersteuning voor agent-sandbox (Docker-in-Docker voor geïsoleerde uitvoering)
Aanhoudende toestand:
- Configuratie:
~/.neotask/neotask.json - Werkruimte:
~/.neotask/workspace/ - Sessies:
~/.neotask/agents/*/sessions/ - Kanaaltoestand:
~/.neotask/whatsapp/, enz.
Kubernetes
Implementeer op Kubernetes met het StatefulSet-patroon voor aanhoudende opslag. Community-beheerde Helm-grafieken zijn beschikbaar.
Typische instelling:
- StatefulSet voor de Gateway (aanhoudende sessies en configuratie)
- ConfigMap voor
neotask.json-configuratie - Secret voor tokens en API-sleutels
- PersistentVolumeClaim voor sessiegegevens en werkruimte
- Service (ClusterIP of LoadBalancer) voor WebSocket-toegang
Fly.io
Implementatie met één opdracht op Fly.io met aanhoudende volumes en automatische HTTPS.
Functies:
- x86 VM met configureerbare RAM (standaard 2048 MB)
- Aanhoudend
/data-volume voor configuratie en sessies - Automatische TLS-beëindiging
- SSH-toegang voor configuratie
- Webhookondersteuning via ngrok (optioneel)
Hetzner VPS
Draaien op een toegewijde Hetzner VPS met Docker Compose. Volledige ondersteuning voor infrastructure-as-code met community Terraform-modules.
Installatie omvat:
- Docker Compose-configuratie
- Aanhoudende mappen voor configuratie, werkruimte en kanaaltoestand
- Aangepaste Dockerfile voor het inbakken van vereiste binaries
- Firewall en beveiligingsharding
Render
Op blauwdruk gebaseerde implementatie op Render met automatische builds en 1 GB aanhoudende schijf.
GCP Compute Engine
Op Docker gebaseerde implementatie op Google Cloud met aanhoudende schijf en opstartautomatisering.
Podman
Rootloze containeruitvoering met Podman en systemd Quadlet-ondersteuning. Ideaal voor omgevingen waar toegang tot de Docker-daemon beperkt is.
Een implementatie kiezen
| Behoefte | Aanbevolen |
|---|---|
| Gewoon uitproberen | Lokale installatie |
| Persoonlijk gebruik op uw Mac | Lokaal + macOS companion-app |
| Altijd-aan-server | Docker op VPS (Hetzner, DigitalOcean) |
| Productie met schaling | Kubernetes |
| Snelle cloud-implementatie | Fly.io of Render |
| Rootloze containers | Podman |
Externe toegang
Standaard luistert de Gateway alleen op localhost (127.0.0.1). Voor externe toegang:
- Tailscale, VPN-meshnetwerk met automatische DNS. De Gateway kan worden gekoppeld aan uw Tailnet voor veilige toegang van overal. Tailscale Serve kan het dashboard beschikbaar stellen via HTTPS.
- SSH-tunnel, Stuur de Gateway-poort door via SSH voor veilige externe toegang zonder poorten bloot te stellen.
- LAN-binding, Binden aan uw lokale netwerk voor toegang vanaf andere apparaten op hetzelfde netwerk. Automatische detectie via Bonjour/mDNS.
Zie Gateway voor configuratiedetails.