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