Files

T

tomasz-syn-grzegorza 359afb3a59 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

2.6 KiB

Raw Blame History

Instalacja GPU Fan — krok po kroku

Cel: Zainstalować sterowanie wentylatorami GPU na serwerze.
Czas: ~10 minut
Wymagania: sudo, działający nvidia-smi, internet (pip)

Krok 0 — Sprawdź kartę graficzną

Na serwerze wpisz:

nvidia-smi

Co zobaczysz gdy OK: tabela z nazwą karty (np. RTX 3090 Ti), driverem, temperaturą.

Gdy nie działa: najpierw napraw sterownik NVIDIA. Bez tego GPU Fan nie ma sensu.

Krok 1 — Wejdź do katalogu stacku

cd ~/cursor/ubuntu-bare-metal/stacks/gpu-fan

(Ścieżka może być inna — ważne żebyś był w folderze z plikiem app.py.)

Krok 2 — Zainstaluj na hoście (NIE Docker)

sudo scripts/install.sh

Skrypt:

kopiuje pliki do /opt/gpu-fan
tworzy /etc/gpu-fan/curve.json (domyślna krzywa chłodzenia)
tworzy /opt/control-plane/.env z losowym API_KEY (przy pierwszej instalacji)
instaluje usługę systemd gpu-fan

Co zobaczysz gdy OK: komunikat „Installed to /opt/gpu-fan” i instrukcja startu.

Krok 3 — Włącz dostęp z sieci lokalnej (LAN)

sudo scripts/enable-lan.sh

Ustawia nasłuch na 0.0.0.0:8090 i upewnia się że jest API_KEY.

Krok 4 — Uruchom usługę

sudo systemctl start gpu-fan
sudo systemctl enable gpu-fan

enable = start automatyczny po restarcie serwera.

Krok 5 — Sprawdź czy działa

sudo systemctl status gpu-fan

Co zobaczysz gdy OK: Active: active (running) na zielono.

Logi na żywo:

journalctl -u gpu-fan -f

(Wyjdź: Ctrl+C)

Test API (skopiuj całość):

API_KEY=$(grep ^API_KEY= /opt/control-plane/.env | cut -d= -f2)
curl -s http://127.0.0.1:8090/api/status -H "X-API-Key: $API_KEY" | head -c 200

Co zobaczysz gdy OK: JSON z "temperature_c" i "mode".

Krok 6 — Otwórz panel w przeglądarce

→ 02-OTWIERANIE-UI-W-PRZEGLADARCE.md

Po aktualizacji kodu w repo

Jeśli zmieniłeś pliki w stacks/gpu-fan/:

cd ~/cursor/ubuntu-bare-metal/stacks/gpu-fan
sudo scripts/install.sh
sudo systemctl restart gpu-fan

Czego NIE robić

Nie rób tego	Dlaczego
`sudo scripts/start.sh` + `systemctl start gpu-fan` naraz	Dwa programy na porcie 8090 — błąd
Instalacja w Dockerze	Nie wspierane — patrz 05-DLACZEGO-NIE-DOCKER.md
Edycja tylko `stacks/control-plane/.env`	Produkcja czyta `/opt/control-plane/.env`

Co zrobić gdy nie działa

→ 04-CZESTE-BLEDY.md

2.6 KiB Raw Blame History