diff --git a/README.md b/README.md index 8545813..a10168e 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,26 @@ Basisrouten nach dem Start: ### Windows (empfohlen) -Installiere die erforderlichen Tools mit winget: +#### 1. WSL + Ubuntu installieren + +WSL ist die Grundlage fuer den Workshop (alle Test-Kommandos laufen spaeter in der Linux-Shell). In einer **PowerShell als Administrator**: + +```powershell +wsl --install -d Ubuntu-24.04 +``` + +Das installiert WSL2 samt Ubuntu 24.04. Danach **Windows neu starten** und beim ersten Ubuntu-Start einen Linux-Benutzer (Name + Passwort) anlegen. + +Pruefen bzw. verfuegbare Distros anzeigen: + +```powershell +wsl --list --verbose # bereits installierte Distros + WSL-Version +wsl --list --online # installierbare Distros +``` + +Ist WSL schon vorhanden, nur aktualisieren: `wsl --update`. Fehlt nur die Distro, separat nachziehen: `wsl --install -d Ubuntu-24.04`. + +#### 2. Tools installieren (winget) ```powershell winget install --id Microsoft.VisualStudioCode -e @@ -40,15 +59,17 @@ winget install --id Git.Git -e winget install --id Docker.DockerDesktop -e ``` -Optional fuer TLS-Challenges: +Nach der Installation von Docker Desktop die WSL-Integration in den Einstellungen aktivieren (Settings -> Resources -> WSL Integration -> Ubuntu-24.04). -```powershell -winget install --id OpenSSL.OpenSSL -e -winget install --id WiresharkFoundation.Wireshark -e +#### 3. Optionale TLS-Tools (in Ubuntu/WSL) + +Die TLS-Challenges (Easy-RSA, OpenSSL, Wireshark/tshark) laufen am besten **innerhalb WSL**. Im Ubuntu-Terminal: + +```bash +sudo apt update +sudo apt install -y easy-rsa openssl tshark ``` -Nach der Installation von Docker Desktop die WSL-Integration in den Einstellungen aktivieren. - ### Linux / macOS Docker Engine oder Docker Desktop installieren.