# Diagnostiquer une installation

> Repérez le composant en défaut avant de modifier la configuration.

Source: https://usefiretower.com/fr/docs/troubleshoot

## Recueillir les informations de base

Exécutez ces commandes sur le serveur du plan de contrôle. Utilisez le dossier choisi lors de l’installation.

```
firetower --dir /opt/firetower status
firetower --dir /opt/firetower doctor
firetower --dir /opt/firetower logs
```

## Partir du symptôme

| Problème | À vérifier en premier |
| --- | --- |
| L’application ne joint pas le serveur | Ouvrez l’URL dans un navigateur ; vérifiez le VPN, le DNS et TLS |
| Le serveur est accessible, mais la connexion échoue | L’état du compte, le mot de passe temporaire et la configuration du proxy de confiance |
| Aucune machine ne peut lancer de tâche | [La configuration du worker](https://usefiretower.com/fr/docs/machines) et [son état de préparation](https://usefiretower.com/fr/docs/machines#section-5) |
| Un seul fournisseur est en échec | [Les identifiants de l’agent](https://usefiretower.com/fr/docs/accounts) ou [les autorisations de la plateforme Git](https://usefiretower.com/fr/docs/git) |
| Une exécution reste en attente sans raison apparente | Les demandes d’autorisation, le quota et la connexion au worker |
| Une mise à jour s’est arrêtée | [L’étape concernée et l’erreur enregistrée](https://usefiretower.com/fr/docs/updates) |

## Préparer un signalement utile

-   Indiquez l’heure, le composant concerné et les versions.
-   Décrivez le résultat attendu et l’erreur exacte.
-   Joignez les diagnostics utiles après avoir vérifié qu’ils ne contiennent pas de secrets.
-   Précisez si le problème touche tout le monde, une machine ou un compte.

N’incluez pas le fichier `.env` , de clés racines, de jetons de fournisseur ou de contenu de dépôt privé dans un signalement public.