# Dlaczego GPU Fan NIE jest w Dockerze

**Cel:** Zrozumieć dlaczego instalujemy na hoście, a nie jak ComfyUI.  
**Czas:** 3 minuty  
**Wymagania:** Brak

---

## Krótka odpowiedź

GPU Fan **musi** siedzieć na hoście obok sterownika NVIDIA. W Dockerze **nie ma** gotowego obrazu w tym repo i **nie planujemy** go dodawać.

ComfyUI / LocalAI = programy w kontenerach (obliczenia AI).  
GPU Fan = „termometr + regulator wentylatorów” na poziomie sprzętu.

---

## Analogia

| Co | Gdzie | Dlaczego |
|----|-------|----------|
| Aplikacja w przeglądarce | Docker OK | Nie dotyka wentylatorów bezpośrednio |
| Sterownik wentylatorów karty | Host (root) | Tylko system z uprawnieniami root może pisać do NVML |

To jak termostat w kotłowni — nie wkładasz go do pudełka z aplikacją webową w innym pokoju.

---

## Co by się stało w Dockerze (gdyby ktoś próbował)

1. Kontener musiałby być **privileged** i **root**
2. I tak często dostaniesz **Insufficient Permissions** na kartach GeForce
3. Po awaryjnym `docker kill` wentylatory mogłyby zostać w trybie ręcznym
4. Zero korzyści — i tak potrzebujesz tego samego sterownika na hoście

Dlatego w repo jest tylko:

```bash
sudo scripts/install.sh
sudo systemctl start gpu-fan
```

---

## Jak to wygląda na serwerze (poprawnie)

```
HOST (Ubuntu)
├── gpu-fan.service  ← steruje wentylatorami (port 8090)
├── sterownik NVIDIA
└── Docker
    ├── comfyui  :8188
    ├── localai  :8070
    └── vllm     :8000
```

Wszystko może działać **równocześnie**. GPU Fan nie koliduje z kontenerami AI.

---

## „Ale inne stacki są w Dockerze!”

Tak — bo tam Docker **ma sens** (izolacja aplikacji, GPU do inference).

GPU Fan to **daemon sprzętowy** — jak `nvidia-persistenced`, nie jak aplikacja webowa.

---

## Gdzie jest pełna analiza techniczna

Dla agentów / deweloperów:  
[../coding-agent/DOCKER-VS-HOST-REPORT.md](../coding-agent/DOCKER-VS-HOST-REPORT.md)

---

## Co robić zamiast Dockera

→ [01-INSTALACJA-KROK-PO-KROKU.md](01-INSTALACJA-KROK-PO-KROKU.md)