# Dépannage

## "spawn tmux ENOENT"

tmux n'est pas installé ou ne figure pas dans votre PATH. Termbridge affiche cette erreur, mais continue actuellement de s'exécuter sans fournir de terminal ([#4](https://github.com/inline0/termbridge/issues/4)) ; appuyez sur `Ctrl+C`, installez tmux et relancez-le.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

## "spawn cloudflared ENOENT"

Le client de tunnel de Cloudflare n'est pas installé ou ne figure pas dans votre PATH. Il est requis uniquement en mode tunnel ; les modes directs `--no-tunnel` et Daytona n'ont pas besoin de cloudflared.

```bash
# macOS
brew install cloudflared
```

Pour Linux, téléchargez-le depuis [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/).

## Le tunnel ne démarre pas

Quelques points à vérifier (ignorez cette section si vous utilisez le mode direct du bac à sable) :

1. Vérifiez que cloudflared fonctionne : `cloudflared --version`
2. Vérifiez que vous pouvez accéder à `https://trycloudflare.com`
3. Vérifiez qu'un pare-feu ne bloque pas les connexions sortantes

Si le tunnel ne démarre pas, Termbridge affiche l'erreur, arrête son serveur et se ferme avec le statut 1. Il ne bascule pas vers un mode local uniquement, et par défaut le serveur n'écoute que sur `127.0.0.1` ; les autres appareils de votre réseau ne peuvent donc pas y accéder non plus. Les sessions tmux créées pour cette exécution continuent de tourner ([#4](https://github.com/inline0/termbridge/issues/4)).

Pour utiliser Termbridge sans le tunnel Cloudflare, exécutez-le avec `--no-tunnel --public-url <url>` derrière votre propre proxy inverse ou tunnel.

## « 429 Too Many Requests » de trycloudflare

Cloudflare limite le débit des tunnels sans compte. Si vous voyez des erreurs comme `429 Too Many Requests`, essayez :

1. Attendez quelques minutes, puis réessayez
2. Vérifiez qu'aucun ancien processus `cloudflared` ne s'exécute encore
3. Utilisez un jeton de tunnel nommé (recommandé pour un usage fréquent)

## Écran vide ou « Unable to load terminals »

Cela signifie généralement que le navigateur ne dispose d'aucun cookie de session valide, par exemple si la page a été ouverte sans utiliser de lien de partage, ou si le URL du tunnel a changé :

1. Vérifiez si le serveur local est toujours en cours d'exécution
2. Consultez la console du navigateur pour repérer les erreurs 401/403
3. Redémarrez Termbridge pour obtenir un nouveau code URL et QR

## Aucune sortie dans le terminal

La session tmux ne s'exécute peut-être pas :

```bash
# Check if sessions exist
tmux ls
```

Si des sessions s'affichent, mais que le terminal reste vide, essayez :
- de recharger la page
- de vérifier que votre shell prend en charge `TERM=xterm-256color`

## Le code QR est scanné, mais la page est vide

Le code QR contient un jeton à usage unique. Il ne fonctionne qu'une fois, et uniquement dans les 90 secondes suivant le démarrage de Termbridge. Un lien déjà utilisé ou expiré renvoie `invalid token`.

Solution : redémarrez Termbridge pour générer un nouveau code QR, puis scannez-le immédiatement.

## Erreurs node-pty concernant spawn-helper

Termbridge tente de résoudre ce problème automatiquement, mais si vous voyez des erreurs d'autorisation :

```bash
chmod +x node_modules/node-pty/prebuilds/**/spawn-helper
```

## Toujours bloqué ?

Ouvrez un ticket sur [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) avec les informations suivantes :
- Votre système d'exploitation et la version Node.js
- Le message d'erreur
- Les étapes pour reproduire le problème