# Distribution

Neotask kan köras var som helst, från din laptop till ett Kubernetes-kluster. Välj distributionsmetoden som passar dina behov.

## Lokal installation

Det enklaste sättet att komma igång. Installera Neotask direkt på macOS, Linux eller Windows (via WSL2). Gateway körs som en bakgrundstjänst hanterad av launchd (macOS) eller systemd (Linux).

**Krav:** Node.js 22+

**Vad du får:**
- Gateway som körs som en bakgrundstjänst
- Automatisk start vid uppstart
- macOS-följapp (på macOS)
- Alla CLI-verktyg

## Docker

Kör Gateway i en Docker-container med beständiga konfigurations- och arbetsytevolumer. Idealisk för VPS-distributioner eller när du vill ha isolering från ditt värdsystem.

**Funktioner:**
- Förbyggda avbildningar baserade på Node 22 (Debian)
- Valfritt Chromium + Xvfb för webbläsarautomatisering (lägger till ~300MB)
- Docker Compose-konfiguration med beständiga volymer
- Hälsokontrollslutpunkt vid `/health`
- Körs som icke-root `node`-användare
- Agentsandlåde-stöd (Docker-in-Docker för isolerad exekvering)

**Beständigt tillstånd:**
- Konfiguration: `~/.neotask/neotask.json`
- Arbetsyta: `~/.neotask/workspace/`
- Sessioner: `~/.neotask/agents/*/sessions/`
- Kanaltillstånd: `~/.neotask/whatsapp/`, osv.

## Kubernetes

Distribuera till Kubernetes med hjälp av StatefulSet-mönstret för beständig lagring. Community-underhållna Helm-diagram är tillgängliga.

**Typisk konfiguration:**
- **StatefulSet** för Gateway (beständiga sessioner och konfiguration)
- **ConfigMap** för `neotask.json`-konfiguration
- **Secret** för tokens och API-nycklar
- **PersistentVolumeClaim** för sessionsdata och arbetsyta
- **Service** (ClusterIP eller LoadBalancer) för WebSocket-åtkomst

## Fly.io

Ett-kommando-distribution till Fly.io med beständiga volymer och automatisk HTTPS.

**Funktioner:**
- x86 VM med konfigurerbart RAM (standard 2048MB)
- Beständig `/data`-volym för konfiguration och sessioner
- Automatisk TLS-terminering
- SSH-åtkomst för konfiguration
- Webhook-stöd via ngrok (valfritt)

## Hetzner VPS

Kör på en dedikerad Hetzner VPS med Docker Compose. Fullt stöd för infrastruktur-som-kod med community Terraform-moduler.

**Konfigurationen inkluderar:**
- Docker Compose-konfiguration
- Beständiga kataloger för konfiguration, arbetsyta och kanaltillstånd
- Anpassad Dockerfile för att baka in nödvändiga binärer
- Brandvägg och säkerhetshärdning

## Render

Ritningsbaserad distribution på Render med automatiska byggen och 1GB beständig disk.

## GCP Compute Engine

Docker-baserad distribution på Google Cloud med beständig disk och startautomatisering.

## Podman

Rootlös containerexekvering med Podman och systemd Quadlet-stöd. Idealisk för miljöer där åtkomst till Docker-daemon är begränsad.

## Välja en distribution

| Behov | Rekommenderas |
|------|-------------|
| Bara prova det | Lokal installation |
| Personligt bruk på din Mac | Lokal + macOS-följapp |
| Alltid-på-server | Docker på VPS (Hetzner, DigitalOcean) |
| Produktion med skalning | Kubernetes |
| Snabb molndistribution | Fly.io eller Render |
| Rootlösa containrar | Podman |

## Fjärråtkomst

Som standard lyssnar Gateway bara på localhost (127.0.0.1). För fjärråtkomst:

- **Tailscale**, VPN-meshnätverk med automatisk DNS. Gateway kan binda till ditt Tailnet för säker åtkomst var som helst. Tailscale Serve kan exponera instrumentpanelen med HTTPS.
- **SSH-tunnel**, Vidarebefordra Gateway-porten via SSH för säker fjärråtkomst utan att exponera portar.
- **LAN-bindning**, Bind till ditt lokala nätverk för åtkomst från andra enheter på samma nätverk. Automatisk upptäckt via Bonjour/mDNS.

Se [Gateway](gateway.md) för konfigurationsdetaljer.