Initial import: bare-metal stacks, Server UI, GPU fan, tutorials.

Infrastructure configs for GMKtec K11 (Docker, vLLM, LocalAI, ComfyUI, control-plane, gpu-fan agent, Server UI with CLI/file explorer/GPU fan curve). Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-05 12:02:04 +00:00
commit 359afb3a59
153 changed files with 18169 additions and 0 deletions
@@ -0,0 +1,78 @@
+# 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)