From 239cb9a90ab0b8c2f6a440e522d94982eb0270bc Mon Sep 17 00:00:00 2001
From: hkoeck <herwig.koeck@gmail.com>
Date: Sun, 31 May 2026 22:50:53 +0200
Subject: [PATCH] Ergaenze WSL-Installation in der Windows-Anleitung

Die Windows-Voraussetzungen setzten WSL stillschweigend voraus. WSL
kann aber fehlen - dann scheitert der ganze Workshop am ersten Schritt.

- Schritt 1 neu: WSL2 + Ubuntu-24.04 per "wsl --install -d Ubuntu-24.04"
  (Admin-PowerShell), inkl. Neustart-/Benutzer-Hinweis und den Pruef-/
  Update-Kommandos (wsl --list --verbose/--online, wsl --update)
- Windows-Abschnitt in nummerierte Schritte gegliedert (WSL -> Tools -> TLS)
- Optionale TLS-Tools auf apt-in-WSL umgestellt (easy-rsa openssl tshark)
  statt nativem winget-OpenSSL/Wireshark - deckt sich mit wireshark-hints
  (natives Windows-Wireshark schneidet Docker-Loopback nicht zuverlaessig mit)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 README.md | 35 ++++++++++++++++++++++++++++-------
 1 file changed, 28 insertions(+), 7 deletions(-)

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.