# Wdrożenie

Neotask może działać wszędzie -- od laptopa po klaster Kubernetes. Wybierz metodę wdrożenia odpowiadającą Twoim potrzebom.

## Lokalna instalacja

Najprostszy sposób na rozpoczęcie. Zainstaluj Neotask bezpośrednio na macOS, Linux lub Windows (przez WSL2). Brama działa jako usługa w tle zarządzana przez launchd (macOS) lub systemd (Linux).

**Wymagania:** Node.js 22+

**Co otrzymujesz:**
- Brama działająca jako usługa w tle
- Automatyczne uruchamianie przy starcie
- Aplikacja towarzysząca macOS (na macOS)
- Wszystkie narzędzia CLI

## Docker

Uruchamiaj bramę w kontenerze Docker z trwałymi woluminami konfiguracji i przestrzeni roboczej. Idealne do wdrożeń VPS lub gdy chcesz izolacji od systemu hosta.

**Funkcje:**
- Wstępnie zbudowane obrazy oparte na Node 22 (Debian)
- Opcjonalny Chromium + Xvfb do automatyzacji przeglądarki (dodaje ~300MB)
- Konfiguracja Docker Compose z trwałymi woluminami
- Punkt końcowy sprawdzania stanu w `/health`
- Działa jako użytkownik `node` bez uprawnień roota
- Obsługa piaskownicy agenta (Docker-in-Docker dla izolowanego wykonania)

**Trwały stan:**
- Konfiguracja: `~/.neotask/neotask.json`
- Przestrzeń robocza: `~/.neotask/workspace/`
- Sesje: `~/.neotask/agents/*/sessions/`
- Stan kanału: `~/.neotask/whatsapp/` itp.

## Kubernetes

Wdrażaj do Kubernetes używając wzorca StatefulSet dla trwałego przechowywania. Dostępne są wykresy Helm utrzymywane przez społeczność.

**Typowa konfiguracja:**
- **StatefulSet** dla bramy (trwałe sesje i konfiguracja)
- **ConfigMap** dla konfiguracji `neotask.json`
- **Secret** dla tokenów i kluczy API
- **PersistentVolumeClaim** dla danych sesji i przestrzeni roboczej
- **Service** (ClusterIP lub LoadBalancer) dla dostępu WebSocket

## Fly.io

Wdrożenie jednym poleceniem na Fly.io z trwałymi woluminami i automatycznym HTTPS.

**Funkcje:**
- Maszyna wirtualna x86 z konfigurowalną pamięcią RAM (domyślnie 2048MB)
- Trwały wolumin `/data` dla konfiguracji i sesji
- Automatyczne zakończenie TLS
- Dostęp SSH do konfiguracji
- Obsługa webhooków przez ngrok (opcjonalnie)

## Hetzner VPS

Uruchamiaj na dedykowanym VPS Hetzner z Docker Compose. Pełna obsługa infrastruktury jako kodu z modułami Terraform utrzymywanymi przez społeczność.

**Konfiguracja obejmuje:**
- Konfiguracja Docker Compose
- Trwałe katalogi dla konfiguracji, przestrzeni roboczej i stanu kanału
- Niestandardowy Dockerfile do pieczenia wymaganych binariów
- Zapora i utwardzanie bezpieczeństwa

## Render

Wdrożenie oparte na planie na platformie Render z automatycznymi kompilacjami i 1GB trwałego dysku.

## GCP Compute Engine

Wdrożenie oparte na Docker na Google Cloud z trwałym dyskiem i automatyzacją uruchamiania.

## Podman

Wykonanie kontenerów bez uprawnień roota z obsługą Podman i systemd Quadlet. Idealne dla środowisk, gdzie dostęp do demona Docker jest ograniczony.

## Wybór wdrożenia

| Potrzeba | Zalecane |
|---------|----------|
| Tylko wypróbowanie | Lokalna instalacja |
| Użytek osobisty na Macu | Lokalna + aplikacja towarzysząca macOS |
| Serwer zawsze włączony | Docker na VPS (Hetzner, DigitalOcean) |
| Produkcja ze skalowaniem | Kubernetes |
| Szybkie wdrożenie w chmurze | Fly.io lub Render |
| Kontenery bez uprawnień roota | Podman |

## Zdalny dostęp

Domyślnie brama nasłuchuje tylko na localhost (127.0.0.1). Dla zdalnego dostępu:

- **Tailscale** -- Sieć VPN mesh z automatycznym DNS. Brama może być powiązana z Twoją siecią Tailnet dla bezpiecznego dostępu z dowolnego miejsca. Tailscale Serve może udostępniać panel sterowania z HTTPS.
- **Tunel SSH** -- Przekaż port bramy przez SSH dla bezpiecznego zdalnego dostępu bez otwierania portów.
- **Powiązanie LAN** -- Powiąż z lokalną siecią dla dostępu z innych urządzeń w tej samej sieci. Automatyczne odkrywanie przez Bonjour/mDNS.

Szczegółowe informacje o konfiguracji znajdziesz w artykule [Brama](gateway.md).