# Dépannage

## Les clés RSA ne sont pas prises en charge

Tessera ne peut ni générer ni importer de clés RSA : la pile SSH actuelle ne
sait proposer que la signature RSA/SHA-1, obsolète. Générez plutôt une
[clé Ed25519](https://bambouville.com/docs/fr/keys/#générer-une-clé) — tous les serveurs OpenSSH modernes
l'acceptent. Les clés RSA héritées d'anciennes versions sont affichées
désactivées.

## Mosh ne se connecte pas

- `mosh-server` est-il installé sur le serveur ?
- L'UDP atteint-il le serveur ? Certains pare-feu et la plupart des NAT le
  bloquent ; mosh a besoin des ports UDP 60000–61000 par défaut.
- Via un [hôte de rebond](https://bambouville.com/docs/fr/connections/#hôtes-de-rebond) : l'UDP de mosh ne
  peut pas traverser les bastions. Tessera avertit (« mosh est injoignable via
  la chaîne de rebonds… ») et retombe sur SSH.

## La redirection refuse un port local

Le bac à sable iOS ne peut pas se lier aux ports inférieurs à 1024 — choisissez
un port local plus élevé. Les ports locaux ne peuvent pas non plus se répéter
au sein d'un même hôte. Voir [redirection de ports](https://bambouville.com/docs/fr/port-forwarding/).

## La redirection est désactivée sur un hôte Mosh

Avec le transport mosh et le mode de lancement **personnalisé**, il n'y a
aucune connexion SSH pour porter les redirections. Passez le mode de lancement
à **tmux automatique** ou **tmux nommé** — ces modes gardent un canal SSH
secondaire sur lequel la redirection s'appuie.

## Une connexion reste bloquée sur « connexion » ou « démarrage de tmux »

Attendez douze secondes : la surcouche de lancement nomme l'étape sur laquelle
elle bloque et propose **modifier l'hôte**, **réessayer** et **retour** — fini
le spinner sans fin. Si le problème vient de tmux lui-même (pas installé,
démarrage impossible, ou dotfiles de l'hôte qui lancent déjà tmux à la
connexion), Tessera bascule sur un shell simple avec une bannière qui en nomme
la raison. Et si une session s'attache mais que l'écran reste vide, une
bannière indique « appuyez sur n'importe quelle touche pour le réveiller » —
faites-le. Voir
[quand une connexion bloque](https://bambouville.com/docs/fr/connections/#quand-une-connexion-senlise).

## tmux n'a pas pris en compte mes changements

Les variables d'environnement et les extraits de démarrage ne s'exécutent qu'au
démarrage de la session tmux. Fermez la session sur le serveur
(`tmux kill-session`) et reconnectez-vous.

## Le panneau fichiers dit que la clé d'hôte n'est pas approuvée

Le pont de fichiers est une connexion SSH distincte, soumise aux mêmes règles
de confiance. Ouvrez une session de terminal vers l'hôte, examinez la
[feuille hôte inconnu](https://bambouville.com/docs/fr/host-keys/#première-connexion) et acceptez la clé — puis
rouvrez le panneau.

## Le panneau fichiers ne suit pas mon shell

Le suivi de répertoire nécessite OSC 7 depuis votre shell. Utilisez le bouton
**Activer le suivi — installer l'intégration au shell** du panneau, puis
`exec $SHELL` ou reconnectez-vous. Détails dans
[fichiers](https://bambouville.com/docs/fr/files/#suivre-votre-shell).

## Les sessions vers un hôte WSL se figent en pleine sortie

La connexion est saine, mais les grosses rafales de sortie n'arrivent jamais —
une MTU incohérente sur l'adaptateur virtuel de WSL2, qui avale tous les gros
paquets. Voir [blocages de MTU sous WSL](https://bambouville.com/docs/fr/wsl-mtu/).

## Les connexions au réseau local échouent

iOS conditionne l'accès au LAN à l'autorisation **Réseau local**. Si vous
l'avez refusée, réactivez-la dans l'app Réglages, sous Tessera. C'est la même
autorisation qui permet à la [configuration à proximité](https://bambouville.com/docs/fr/nearby-setup/) de
trouver votre autre appareil.

## La configuration à proximité ne trouve aucun appareil

Les deux appareils doivent avoir Tessera ouvert **sur l'écran de
configuration**, au premier plan, sur le même réseau, avec l'autorisation
Réseau local accordée des deux côtés. Une différence de version s'arrête sur
un message explicite « mettez Tessera à jour sur … ». Voir
[configuration à proximité](https://bambouville.com/docs/fr/nearby-setup/#avant-de-commencer).

## Handoff n'apparaît pas sur l'autre appareil

Handoff est de la plomberie Apple : même compte Apple sur les deux appareils,
Bluetooth et Wi-Fi activés, et Handoff activé dans l'app Réglages d'iOS. Un
appareil verrouillé cesse d'émettre, volontairement. La reprise de la main sur
les sessions tmux partagées nécessite en plus **tmux 3.2+** sur le serveur.
Voir [continuité](https://bambouville.com/docs/fr/continuity/).

## Une carte d'agent affiche « état indisponible »

La découverte a trouvé l'agent, mais un état précis exige le hook d'état propre
à l'hôte — installez-le ou mettez-le à jour depuis la carte. Sur Codex, le
premier lancement intégré peut aussi vous demander d'approuver le hook via
`/hooks`. Voir
[centre d'agents](https://bambouville.com/docs/fr/agent-center/#comment-fonctionne-la-détection).

## Les notifications n'arrivent pas

Vérifiez l'autorisation de notification d'iOS (la feuille des réglages de cloche
y renvoie directement). Rappelez-vous que la remise en arrière-plan se fait au
mieux : iOS peut suspendre les sessions d'arrière-plan longues. Voir
[notifications](https://bambouville.com/docs/fr/notifications/).

## Un achat n'a pas été repris

**réglages → hôtes illimités → restaurer les achats** revérifie votre compte
Apple — ce qui couvre les réinstallations, les nouveaux appareils et le
déblocage inclus dans un achat de l'app payante d'origine. Voir
[gratuit et hôtes illimités](https://bambouville.com/docs/fr/unlimited-hosts/).

## Autre chose

**réglages → diagnostics → envoyer au développeur** ouvre un mail pré-adressé
avec le journal de diagnostics en pièce jointe — vous voyez tout avant
d'appuyer sur envoyer. (Il faut un compte mail sur l'appareil ; à défaut,
utilisez **exporter le journal** et envoyez le fichier depuis n'importe quelle
app de messagerie.) Ou signalez un problème sur
[GitHub Issues](https://github.com/bambouville/tessera/issues). Le journal est
expurgé et ne quitte votre appareil que lorsque vous l'envoyez.