# Fehlerbehebung

## RSA-Keys werden nicht unterstützt

Tessera kann keine RSA-Keys erzeugen oder importieren: Der aktuelle SSH-Stack
kann nur die veraltete RSA/SHA-1-Signatur anbieten. Erzeugen Sie stattdessen
einen [Ed25519-Key](https://bambouville.com/docs/de/keys/#einen-key-erzeugen) — jeder moderne
OpenSSH-Server akzeptiert ihn. RSA-Keys aus älteren Versionen werden
deaktiviert angezeigt.

## mosh verbindet sich nicht

- Ist `mosh-server` auf dem Server installiert?
- Erreicht UDP den Server? Manche Firewalls und die meisten NATs blockieren
  es; mosh braucht standardmäßig die UDP-Ports 60000–61000.
- Über einen [Jump-Host](https://bambouville.com/docs/de/connections/#jump-hosts): Das UDP von mosh kann
  Bastionen nicht durchqueren. Tessera warnt („mosh ist über die Jump-Kette
  nicht erreichbar …“) und fällt auf SSH zurück.

## Die Weiterleitung verweigert einen lokalen Port

Die iOS-Sandbox kann unterhalb von 1024 nicht binden — wählen Sie einen
höheren lokalen Port. Außerdem darf sich ein lokaler Port innerhalb eines
Hosts nicht wiederholen. Siehe [Portweiterleitung](https://bambouville.com/docs/de/port-forwarding/).

## Die Weiterleitung ist auf einem mosh-Host deaktiviert

Mit dem Transport mosh und dem Startmodus **eigen** gibt es keine
SSH-Verbindung, über die Weiterleitungen laufen könnten. Stellen Sie den
Startmodus auf **Auto-tmux** oder **benanntes tmux** um — diese halten einen
SSH-Seitenkanal offen, den die Weiterleitung mitbenutzt.

## Eine Verbindung bleibt bei „verbinde“ oder „starte tmux“ stehen

Warten Sie zwölf Sekunden: Die Start-Überlagerung benennt die Phase, in der es
klemmt, und bietet **Host bearbeiten**, **erneut versuchen** und **zurück** —
kein endloser Spinner mehr. Liegt es an tmux selbst (nicht installiert,
startet nicht, oder die Dotfiles des Hosts starten tmux bereits beim Login),
fällt Tessera auf eine einfache Shell zurück, mit einem Banner, das den Grund
nennt. Und hängt sich eine Sitzung an, während der Bildschirm leer bleibt,
sagt ein Banner „drücke eine beliebige Taste, um ihn aufzuwecken“ — tun Sie
das. Siehe
[wenn eine Verbindung hängt](https://bambouville.com/docs/de/connections/#wenn-eine-verbindung-hängt).

## tmux hat meine Änderungen nicht übernommen

Umgebungsvariablen und Startskripte laufen nur, wenn die tmux-Sitzung startet.
Beenden Sie die Sitzung auf dem Server (`tmux kill-session`) und verbinden Sie
sich neu.

## Das Dateien-Panel sagt, dem Host-Key werde nicht vertraut

Die Dateibrücke ist eine eigene SSH-Verbindung mit denselben Vertrauensregeln.
Öffnen Sie eine Terminal-Sitzung zum Host, prüfen Sie das
[Fenster „unbekannter Host“](https://bambouville.com/docs/de/host-keys/#erste-verbindung) und akzeptieren
Sie den Key — öffnen Sie danach das Panel erneut.

## Das Dateien-Panel folgt meiner Shell nicht

Damit das Verzeichnis mitläuft, muss Ihre Shell OSC 7 senden. Nutzen Sie im
Panel die Taste **Mitlaufen aktivieren – Shell-Integration installieren** und
führen Sie danach `exec $SHELL` aus oder verbinden Sie sich neu. Details unter
[Dateien](https://bambouville.com/docs/de/files/#der-shell-folgen).

## Sitzungen zu einem WSL-Host frieren mitten in der Ausgabe ein

Die Verbindung ist in Ordnung, aber große Ausgabeschübe kommen nie an — eine
MTU-Abweichung am virtuellen Adapter von WSL2, die jedes große Paket
verschluckt. Siehe [WSL-MTU-Hänger](https://bambouville.com/docs/de/wsl-mtu/).

## Verbindungen im lokalen Netz schlagen fehl

iOS schützt den Zugriff auf das lokale Netz mit der Berechtigung
**Lokales Netzwerk**. Haben Sie sie verweigert, aktivieren Sie sie in der App
„Einstellungen“ unter Tessera wieder. Dieselbe Berechtigung lässt
[Einrichtung in der Nähe](https://bambouville.com/docs/de/nearby-setup/) Ihr anderes Gerät finden.

## Einrichtung in der Nähe findet keine Geräte

Auf beiden Geräten muss Tessera **im Einrichtungsbildschirm** geöffnet sein,
im Vordergrund, im selben Netz und mit erteilter Berechtigung für das lokale
Netzwerk. Passen die Versionen nicht zusammen, bricht der Vorgang mit einer
ausdrücklichen Meldung „Aktualisiere Tessera auf …“ ab. Siehe
[Einrichtung in der Nähe](https://bambouville.com/docs/de/nearby-setup/#bevor-sie-beginnen).

## Handoff erscheint nicht auf dem anderen Gerät

Handoff ist Apple-Infrastruktur: dasselbe Apple-Konto auf beiden Geräten,
Bluetooth und WLAN an und aktiviertes Handoff in der iOS-App „Einstellungen“.
Ein gesperrtes Gerät stellt das Ankündigen absichtlich ein. Das Zurückholen
geteilter tmux-Sitzungen braucht außerdem **tmux 3.2+** auf dem Server. Siehe
[Kontinuität](https://bambouville.com/docs/de/continuity/).

## Eine Agentenkarte zeigt „Status nicht verfügbar“

Die Erkennung hat den Agenten gefunden, aber für den genauen Zustand ist der
Host-eigene Status-Hook nötig — installieren oder aktualisieren Sie ihn über
die Karte. In Codex kann der erste integrierte Start zusätzlich verlangen,
dem Hook über `/hooks` zu vertrauen. Siehe
[Agent-Center](https://bambouville.com/docs/de/agent-center/#wie-die-erkennung-funktioniert).

## Mitteilungen kommen nicht an

Prüfen Sie die iOS-Mitteilungsberechtigung (das Einstellungsfenster für den
Signalton verlinkt direkt dorthin). Denken Sie daran, dass die Zustellung im
Hintergrund nur nach bestem Bemühen erfolgt: iOS kann lange
Hintergrundsitzungen anhalten. Siehe [Mitteilungen](https://bambouville.com/docs/de/notifications/).

## Ein Kauf wurde nicht übernommen

**Einstellungen → unbegrenzte Hosts → Käufe wiederherstellen** prüft Ihr
Apple-Konto erneut — das deckt Neuinstallationen, neue Geräte und die
Freischaltung ab, die im ursprünglichen Kauf der Bezahl-App enthalten ist.
Siehe [Kostenlos & unbegrenzte Hosts](https://bambouville.com/docs/de/unlimited-hosts/).

## Etwas anderes

**Einstellungen → Diagnose → an den Entwickler senden** öffnet eine
vorbereitete Mail mit dem Diagnose-Log im Anhang — Sie sehen alles, bevor Sie
auf Senden tippen. (Dafür braucht das Gerät ein Mail-Konto; ohne eines nutzen
Sie **Log exportieren** und senden die Datei aus einer beliebigen Mail-App.)
Oder melden Sie ein Problem unter
[GitHub Issues](https://github.com/bambouville/tessera/issues). Das Log ist
bereinigt und verlässt Ihr Gerät nur, wenn Sie es senden.
