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.1 KiB

Raw Blame History

00 — Wymagania i konwencje

Przeczytaj ten rozdział przed rozpoczęciem pracy. Nie wymaga wykonywania komend na serwerze.

Cel

Ustalenie wspólnego kontekstu: jaki sprzęt konfigurujemy, jakie są wymagania wstępne i jak czytać kolejne rozdziały tutoriala.

Sprzęt i system

Parametr	Wartość
Hostname	`gmktec-k11`
System	Ubuntu 26.04 LTS (`resolute`)
Kernel	7.0.x (aktualizowany przez `apt upgrade`)
GPU do AI	NVIDIA GeForce RTX 3090 Ti
Użytkownik	`tomasz-syn-grzegorza` (grupa `sudo`)

Wymagania wstępne

Dostęp SSH lub fizyczna konsola do serwera
Użytkownik z uprawnieniami sudo
Stabilne połączenie internetowe
Czysta instalacja Ubuntu minimized (bez wcześniejszej konfiguracji serwera)

Ubuntu minimized — nie ma edytorów (nano/vim), rsync, parted, jq. Doinstalowujemy je w rozdziale 03b — Narzędzia bazowe przed konfiguracją dysku i vLLM.

Konwencje w tutorialu

Język

Opisy i wyjaśnienia — po polsku
Komendy, nazwy pakietów, ścieżki, zmienne — po angielsku (jak w systemie Linux)

Format komend

# komentarz — wyjaśnienie co robi komenda
sudo apt update

Komendy z prefiksem sudo wymagają uprawnień administratora
$USER oznacza aktualnie zalogowanego użytkownika — nie zamieniaj ręcznie
Bloki oznaczone Opcjonalnie możesz pominąć przy pierwszym przejściu

Oznaczenia w tekście

Oznaczenie	Znaczenie
Weryfikacja	Sprawdź wynik przed przejściem dalej
Troubleshooting	Rozwiązanie typowych problemów
Uwaga	Ważna informacja — przeczytaj przed wykonaniem
Następny krok	Link do kolejnego rozdziału

Kolejność rozdziałów

Nie pomijaj rozdziałów i nie zmieniaj kolejności. Każdy etap buduje na poprzednim:

Aktualizacja systemu + Docker CE
Sterowniki NVIDIA
NVIDIA Container Toolkit (GPU w kontenerach)
vLLM
ComfyUI
Firewall i hardening

Czego NIE instalujemy w kroku 01

W pierwszym rozdziale świadomie pomijamy:

Sterowniki NVIDIA (nvidia-driver-*)
NVIDIA Container Toolkit (nvidia-ctk)
vLLM, ComfyUI i jakiekolwiek compose stacki
Konfigurację firewalla

Te elementy pojawią się w kolejnych rozdziałach we właściwej kolejności.

Przydatne komendy diagnostyczne (bez zmian w systemie)

Możesz je uruchomić teraz, żeby potwierdzić punkt startowy:

# wersja systemu
lsb_release -a

# kernel i architektura
uname -a

# miejsce na dysku
df -h /

# pamięć RAM
free -h

# uprawnienia sudo
groups

# czy Docker jest już zainstalowany (powinno być puste)
which docker
docker --version 2>/dev/null || echo "Docker not installed"

# GPU wykryte przez PCI (sterownik może jeszcze nie być zainstalowany)
lspci | grep -i nvidia

Oczekiwany stan przed rozdziałem 01:

Ubuntu 26.04 LTS
Użytkownik w grupie sudo
Docker nie zainstalowany
nvidia-smi niedostępne (to normalne — sterownik w rozdziale 02)

Następny krok

→ 01 — Aktualizacja systemu i instalacja Docker CE

3.1 KiB Raw Blame History