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>

manual-tutorial/00-prerequisites.md

@@ -0,0 +1,114 @@
+# 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](03b-system-tools.md) 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
+
+```bash
+# 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:
+
+1. Aktualizacja systemu + Docker CE
+2. Sterowniki NVIDIA
+3. NVIDIA Container Toolkit (GPU w kontenerach)
+4. vLLM
+5. ComfyUI
+6. 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:
+
+```bash
+# 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](01-system-update-and-docker.md)