# 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
```