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,163 @@
+# Częste błędy GPU Fan
+
+**Cel:** Naprawić typowe problemy bez zgadywania.  
+**Czas:** zależy od problemu (2–15 min)  
+**Wymagania:** Dostęp SSH do serwera, `sudo`
+
+---
+
+## Szybka diagnostyka (zrób to najpierw)
+
+```bash
+sudo systemctl status gpu-fan
+nvidia-smi
+scripts/status.sh
+```
+
+Skopiuj wynik jeśli dalej nie działa.
+
+---
+
+## Błąd: `Insufficient Permissions` w logach
+
+**Przyczyna:** Program nie działa jako root.
+
+**Naprawa:**
+
+```bash
+sudo systemctl restart gpu-fan
+sudo systemctl status gpu-fan
+```
+
+Nie uruchamiaj `python app.py` bez sudo (chyba że `DRY_RUN=true` tylko do testów).
+
+---
+
+## Błąd: `address already in use` / port 8090 zajęty
+
+**Przyczyna:** Dwie kopie programu naraz (najczęściej systemd + `scripts/start.sh`).
+
+**Naprawa:**
+
+```bash
+sudo systemctl stop gpu-fan
+sudo scripts/status.sh --cleanup
+sudo systemctl start gpu-fan
+```
+
+**Nie zmieniaj portu na 8091** — to maskuje problem, nie go rozwiązuje.
+
+---
+
+## Błąd: Strona w przeglądarce się nie ładuje
+
+| Sprawdź | Komenda |
+|---------|---------|
+| Usługa działa? | `sudo systemctl status gpu-fan` |
+| Port nasłuchuje? | `ss -tlnp \| grep 8090` |
+| LAN włączony? | `grep GPU_FAN_HOST /opt/control-plane/.env` → powinno być `0.0.0.0` |
+| Firewall? | Upewnij się że LAN może dojść do 8090 |
+
+Włącz LAN:
+
+```bash
+sudo scripts/enable-lan.sh
+```
+
+---
+
+## Błąd: `401` / Invalid API key
+
+**Przyczyna:** Zły klucz w URL lub brak nagłówka.
+
+**Naprawa:**
+
+```bash
+grep ^API_KEY= /opt/control-plane/.env
+```
+
+Użyj w przeglądarce:
+
+```
+http://IP_SERWERA:8090/?api_key=KLUCZ_Z_PLIKU
+```
+
+Patrz: [02-OTWIERANIE-UI-W-PRZEGLADARCE.md](02-OTWIERANIE-UI-W-PRZEGLADARCE.md)
+
+---
+
+## Błąd: Zmieniam `.env` w repo i nic się nie dzieje
+
+**Przyczyna:** Produkcja czyta **`/opt/control-plane/.env`**, nie `stacks/control-plane/.env`.
+
+**Naprawa:**
+
+```bash
+sudo nano /opt/control-plane/.env
+sudo systemctl restart gpu-fan
+```
+
+Albo pełna reinstalacja kodu (nie nadpisuje istniejącego `.env`):
+
+```bash
+sudo scripts/install.sh
+```
+
+---
+
+## Błąd: `nvidia-smi` nie działa
+
+**Przyczyna:** Brak / zły sterownik NVIDIA.
+
+GPU Fan **nie naprawi** drivera. Najpierw napraw GPU w systemie, potem wróć do instalacji.
+
+---
+
+## Błąd: Po Ctrl+Z w terminalu port zajęty
+
+**Przyczyna:** Proces zawieszony w tle nadal trzyma port.
+
+**Naprawa:**
+
+```bash
+jobs -l          # zobacz zawieszone
+kill %1          # numer z jobs
+# albo:
+sudo scripts/status.sh --cleanup
+```
+
+---
+
+## Błąd: Krzywa się nie zapisuje
+
+Sprawdź format JSON — 3–7 punktów, temp unikalne, speed 0 lub 30–100.
+
+```bash
+sudo cat /etc/gpu-fan/curve.json
+journalctl -u gpu-fan -n 30
+```
+
+---
+
+## Błąd: Chcę uruchomić w Dockerze
+
+**Odpowiedź:** Nie rób tego. Patrz [05-DLACZEGO-NIE-DOCKER.md](05-DLACZEGO-NIE-DOCKER.md).
+
+---
+
+## Pełny reset (ostateczność)
+
+```bash
+sudo systemctl stop gpu-fan
+sudo scripts/status.sh --cleanup
+cd ~/cursor/ubuntu-bare-metal/stacks/gpu-fan
+sudo scripts/install.sh
+sudo scripts/enable-lan.sh
+sudo systemctl start gpu-fan
+```
+
+Logi:
+
+```bash
+journalctl -u gpu-fan -f
+```