Merge branch 'docs-wsl-install' into 'main'

WSL-Installation in der Windows-Anleitung ergaenzen

See merge request hkoeck/htl-reverse-proxy-tls-lab!2
This commit is contained in:
Herwig Koeck
2026-05-31 20:51:28 +00:00
+28 -7
View File
@@ -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.