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

3.3 KiB

Raw Blame History

04a — Klucz API Server UI (krok po kroku)

Cel: wpisać poprawny klucz API w panelu :8091, żeby działały Start/Stop, CLI, Pliki i GPU Fan.

Szacowany czas: 3 minuty

1. Co to jest klucz API?

To hasło do panelu — bez niego możesz tylko oglądać status stacków. Z kluczem możesz:

Start / Stop / Restart stacków
Terminal CLI
Zakładka Pliki
Sterowanie GPU Fan

2. Gdzie jest JEDYNY plik z kluczem?

Na serwerze produkcyjnym (systemd):

/opt/control-plane/.env

Nie używaj innych plików — stare ścieżki mylą:

Plik	Status
`/opt/control-plane/.env`	TAK — używaj tego
`stacks/control-plane/.env`	tylko dev (po sync ma ten sam klucz)
`stacks/server-ui/.env`	NIE — przestarzałe, ignoruj
`GPU_FAN_AGENT_KEY`	NIE — usunięte, używaj `API_KEY`

3. Wyświetl klucz na serwerze

Zaloguj się na serwer (SSH) i wpisz:

sudo grep ^API_KEY= /opt/control-plane/.env

Przykład wyniku:

API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Skopiuj tylko część po = (bez słowa API_KEY=).

Alternatywa — gotowa instrukcja z linkiem:

bash ~/cursor/ubuntu-bare-metal/stacks/server-ui/scripts/show-api-key.sh

4. Wpisz klucz w panelu (3 kroki)

Krok A — otwórz panel

W przeglądarce na swoim komputerze:

http://<IP-serwera>:8091/

Przykład: http://192.168.100.90:8091/

Krok B — wklej klucz

U góry strony znajdź pole API Key
Wklej skopiowany klucz
Kliknij Zapisz

Krok C — sprawdź

Kliknij Sprawdź klucz
Powinno pojawić się: Klucz poprawny (zielony tekst)
Dopiero teraz używaj Start/Stop, CLI itd.

5. Szybsza metoda — gotowy link

Zamiast kroków B–C możesz otworzyć od razu:

http://<IP-serwera>:8091/?api_key=TWÓJ_KLUCZ_Z_KROKU_3

Klucz zapisze się w przeglądarce automatycznie. Nadal kliknij Sprawdź klucz dla pewności.

6. Jak sprawdzić że wszystko działa

Zakładka Stacki → wybierz stack → Start
Brak czerwonego komunikatu Invalid or missing API key
Status stacku zmienia się na „running”

7. Błąd „Invalid or missing API key” — checklist

#	Sprawdź	Co zrobić
1	Kliknąłeś Zapisz?	Wklej klucz → Zapisz → Sprawdź klucz
2	Stary klucz w przeglądarce?	F12 → Application → Local Storage → usuń `server-ui-api-key`, odśwież stronę
3	Klucz z właściwego pliku?	Tylko `sudo grep ^API_KEY= /opt/control-plane/.env`
4	Panel po restarcie?	`sudo systemctl restart server-ui`
5	Właściwy proces na porcie?	`ss -tlnp \| grep 8091` — powinno być `/opt/server-ui`

8. Po instalacji panelu

Instalator wypisuje gotowy link z kluczem. Jeśli go nie zapisałeś:

bash ~/cursor/ubuntu-bare-metal/stacks/server-ui/scripts/show-api-key.sh

Podsumowanie

Pytanie	Odpowiedź
Gdzie klucz?	`/opt/control-plane/.env` → `API_KEY`
Jak wyświetlić?	`sudo grep ^API_KEY= /opt/control-plane/.env`
Jak wpisać w UI?	Pole API Key → Zapisz → Sprawdź klucz
Gotowy link?	`http://IP:8091/?api_key=KLUCZ`

Powrót: 08 — Server UI · README

3.3 KiB Raw Blame History Unescape Escape