Dépannage

Le DevApp ne se charge pas

Symptôme : Le navigateur affiche une erreur de connexion ou une page blanche sur http://localhost:3003.

Étapes :

Vérifiez que l’agent est en cours d’exécution :
```
fenwave service status
```
S’il est arrêté, démarrez-le :
```
fenwave service start
```
Vérifiez le statut du conteneur DevApp :
```
fenwave local-env --status
```
Si le conteneur n’est pas en cours, démarrez-le :
```
fenwave local-env --start
```
Consultez les logs du DevApp pour détecter des erreurs :
```
fenwave local-env --logs
```

Symptôme : La barre de statut du DevApp affiche “Déconnecté”.

Causes possibles :

Le processus agent s’est arrêté
Le port WebSocket (3001) est bloqué par un pare-feu ou utilisé par un autre processus

Étapes :

Vérifiez que l’agent est en cours d’exécution :
```
fenwave service status
```
Si l’agent tourne mais l’interface reste déconnectée, vérifiez le port utilisé :
```
fenwave info
```

Si le port 3001 est bloqué, configurez un port différent :

fenwave config set --ws-port 3005
fenwave service restart

Symptôme : Le téléchargement d’image échoue avec une erreur d’authentification ou “image introuvable”.

Étapes :

Pour les registres privés, vérifiez que le registre est connecté dans la section Registre.
Vérifiez que la référence de l’image est correcte, y compris l’hôte complet du registre et le tag.
Pour AWS ECR, confirmez que vos identifiants AWS disposent des permissions ecr:GetAuthorizationToken et ecr:BatchGetImage.
Consultez les logs de l’agent pour des détails sur l’erreur :
```
fenwave service logs --tail 50
```

Symptôme : Le panneau Logs n’affiche aucune sortie pour un conteneur en cours.

Étapes :

Assurez-vous que le conteneur écrit sur stdout/stderr (certaines applications écrivent uniquement dans des fichiers).
Essayez d’augmenter le nombre de lignes tail — les logs existent peut-être mais sont plus anciens que la fenêtre tail actuelle.
Vérifiez le statut de connexion de l’agent — s’il est déconnecté, la diffusion des logs est suspendue.

Symptôme : Le DevApp ne démarre pas car le port 3003 est déjà utilisé.

Étapes :

Changez le port du conteneur DevApp :

fenwave config set --container-port <available_port>
fenwave service restart

Consultez les logs complets de l’agent :

fenwave service logs -f

Activez le mode debug pour une sortie détaillée :

fenwave service run --debug

Ou consultez le guide de dépannage du Fenwave Agent pour les problèmes au niveau de l’agent.