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 — 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 : 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.

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.

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 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.

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.

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é 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é.

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é.

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.

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.

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.

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. Le journal est expurgé et ne quitte votre appareil que lorsque vous l'envoyez.