From 59fe939b27027ac41d5bbbaaf10417d8c50434b2 Mon Sep 17 00:00:00 2001
From: Ralf-Peter Wolff <info@rp-wolff.de>
Date: Mon, 4 May 2026 11:35:14 +0200
Subject: [PATCH] Add quick start section at top for Windows/Linux/macOS

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

diff --git a/README.md b/README.md
index ec5dc3e..35dfe07 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,52 @@
 # Upterm – Terminal Session Sharing
 
+---
+
+## ⚡ Schnellstart – Session teilen
+
+> Voraussetzung: upterm installiert (siehe unten). Server läuft auf `upterm.ebesch.de`.
+
+### Linux / macOS
+
+```bash
+upterm host --server ssh://upterm.ebesch.de:2222 --accept -- bash
+```
+
+Per Alias (in `~/.bashrc` / `~/.zshrc`):
+
+```bash
+alias share='upterm host --server ssh://upterm.ebesch.de:2222 --accept -- bash'
+```
+
+```bash
+share
+```
+
+### Windows (PowerShell)
+
+```powershell
+upterm host --server ssh://upterm.ebesch.de:2222 --accept
+```
+
+---
+
+Nach dem Start erscheint der Verbindungstoken sofort im Terminal:
+
+```
+➤ SSH:  ssh TOKEN:HASH@upterm.ebesch.de -p 2222
+```
+
+**Token kopieren und weitergeben** – der Empfänger verbindet sich mit:
+
+```bash
+ssh TOKEN:HASH@upterm.ebesch.de -p 2222
+```
+
+> Kein Tool auf Client-Seite nötig – nur ein SSH-Client.
+
+---
+
+
 Upterm ermöglicht das einfache Teilen von SSH-Sessions. Ideal für Kunden-Support oder Pair-Programming mit externen Personen ohne Teleport-Zugang. Clients benötigen nur einen SSH-Client – keine zusätzliche Software nötig.
 
 ## Architektur