From 5feef6b9d7aa9b41cfd1bde86c81322ca25d3b75 Mon Sep 17 00:00:00 2001
From: Ralf-Peter Wolff <info@rp-wolff.de>
Date: Mon, 4 May 2026 11:30:02 +0200
Subject: [PATCH] Add Windows client installation guide

---
 README.md | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)

diff --git a/README.md b/README.md
index 0907b33..fc67b2d 100644
--- a/README.md
+++ b/README.md
@@ -185,3 +185,77 @@ ssh -o ProxyCommand='upterm proxy wss://TOKEN@upterm.ebesch.de' \
 
 - [GitHub – owenthereal/upterm](https://github.com/owenthereal/upterm)
 - [upterm.dev](https://upterm.dev)
+---
+
+## Windows Client
+
+### Installation via Scoop (empfohlen)
+
+**Scoop installieren** (PowerShell als Administrator):
+
+```powershell
+Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
+```
+
+**Bekanntes Problem: 7zip-Extraktion schlägt fehl (Exit code 1640)**
+
+7zip installiert sich via MSI und schlägt auf manchen Windows-Systemen mit folgendem Fehler fehl:
+
+```
+ERROR Exit code was 1640!
+Failed to extract files from ...\7z2601-x64.msi.
+```
+
+**Workaround:** `lessmsi` als alternativen MSI-Extraktor verwenden:
+
+```powershell
+# Fehlgeschlagene Installation bereinigen
+scoop uninstall 7zip
+scoop cache rm 7zip
+
+# lessmsi als MSI-Extraktor aktivieren
+scoop config use_lessmsi true
+
+# 7zip erneut installieren – diesmal via lessmsi
+scoop install 7zip
+```
+
+**upterm installieren:**
+
+```powershell
+scoop bucket add upterm https://github.com/owenthereal/scoop-upterm
+scoop install upterm
+```
+
+---
+
+### Nutzung unter Windows
+
+**Session starten (PowerShell):**
+
+```powershell
+# Eigener Server, automatisch akzeptieren
+upterm host --server ssh://upterm.ebesch.de:2222 --accept
+
+# Beim ersten Verbinden: Host-Key bestätigen mit "yes"
+# Danach erscheint der Token direkt:
+#   ➤ SSH:  ssh TOKEN:HASH@upterm.ebesch.de -p 2222
+```
+
+> Unter Windows startet upterm standardmäßig eine `powershell -NoLogo` Session statt `bash`.
+
+**Client verbindet sich (nur SSH nötig):**
+
+```powershell
+ssh TOKEN:HASH@upterm.ebesch.de -p 2222
+```
+
+---
+
+### Troubleshooting
+
+| Problem | Lösung |
+|---------|--------|
+| 7zip Exit code 1640 | `scoop config use_lessmsi true`, dann `scoop install 7zip` neu |
+| Host-Key Warnung | Einmalig mit `yes` bestätigen; Fingerprint: `SHA256:nOHK++kJYUJz1bqUY1AM6defn36vTXsgWuSEhr3ltLk` |
+| `upterm` nicht gefunden | PowerShell neu starten (PATH wird erst nach Neustart übernommen) |