# tmux — OSC-11-Leak in Windows Terminal (SSH)

**Stand:** 2026-06-28 · **Status:** gelöst (verifiziert)  
**Issue:** [../issues/2026-06-28-tmux-osc11-windows-terminal-leak.md](../issues/2026-06-28-tmux-osc11-windows-terminal-leak.md)

---

## Symptom

Beim Start von `tmux` oder nach SSH erscheint Text im Prompt, z. B.:

```
11;rgb:0c0c/0c0c/0c0c
```

**Keine Schadsoftware** — das ist eine **Terminal-Kontrollsequenz**, die fälschlich als Tastatureingabe landet.

---

## Ursache

| Teil | Was passiert |
|------|----------------|
| **OSC 11** | tmux fragt die Hintergrundfarbe des Terminals ab |
| **Antwort** | Terminal antwortet z. B. `rgb:0c0c/0c0c/0c0c` (dunkles Grau) |
| **Leak** | Bei SSH-Latenz + zu kurzem `escape-time` bricht tmux die Sequenz ab → Rest landet in `stdin`/Prompt |

Häufig bei: **Windows Terminal** ↔ **SSH** ↔ **tmux** auf Linux-Hosts.

---

## Fix (`~/.tmux.conf`)

Zwei Maßnahmen (beide auf **pve1**, **pve2**, **Horus** deployed):

```bash
# Ansatz 1: tmux mehr Zeit für Escape-Sequenzen (war auf pve2 nur 10 ms)
set -sg escape-time 50

# Ansatz 2: OSC-11-Hintergrundabfrage deaktivieren (Fallback)
set -as terminal-overrides ',*:O11=@'
```

Referenz-Config im Repo: [tmux.conf](tmux.conf)

**Nach Änderung tmux neu laden:**

```bash
tmux kill-server          # alle Sessions beenden
# oder in laufender Session:
tmux source-file ~/.tmux.conf
```

Falls Leak bleibt: `escape-time` schrittweise auf **100** erhöhen (nicht >500 — spürbarer ESC-Lag in vim).

---

## Deploy-Stand

| Host | Pfad | Anmerkung |
|------|------|----------|
| pve1 `192.168.10.5` | `/root/.tmux.conf` | identisch mit Referenz |
| pve2 `192.168.10.4` | `/root/.tmux.conf` | `escape-time` von 10→50 |
| Horus `10.1.1.1` | `/root/.tmux.conf` | neu angelegt |

---

## Referenzen

| Thema | Doc |
|-------|-----|
| pve1 Host | [../pve1/infrastructure-host.md](../pve1/infrastructure-host.md) |
| pve2 Host | [../pve2/infrastructure-host.md](../pve2/infrastructure-host.md) |
| Horus | [../horus/README.md](../horus/README.md) |
| Fish (pve1/pve2) | pve1 `fish-setup.yml`, pve2 `/root/.config/fish/` von pve1 |