Dépannage¶

Guide de dépannage pour les problèmes courants.

Services ne démarrent pas¶

Diagnostic automatique (recommandé)¶

Via MCP, lancer d'abord :

run_self_diagnostic
puis run_self_diagnostic avec auto_repair=true si besoin

Ensuite affiner avec :

list_service_status
read_service_logs sur le service concerné
get_port_diagnostics

Backend¶

# Vérifier les logs
sudo journalctl -u essensys-backend -n 50

# Vérifier le binaire
ls -la /opt/essensys/backend/server

# Vérifier la configuration
cat /opt/essensys/backend/config.yaml

Nginx¶

# Vérifier la configuration
sudo nginx -t

# Vérifier les logs
sudo tail -f /var/log/nginx/error.log

# Vérifier le port
sudo netstat -tlnp | grep :80

Traefik¶

# Vérifier les logs
sudo tail -f /var/log/traefik/traefik.log

# Vérifier la configuration
sudo cat /etc/traefik/traefik.yml

# Vérifier les ports
sudo netstat -tlnp | grep -E ':(80|443)'

MCP¶

# Service MCP
sudo systemctl status essensys-mcp --no-pager -l

# Logs MCP
sudo journalctl -u essensys-mcp -n 80 --no-pager

# Port MCP
sudo ss -ltnp | grep :8083

Problèmes de connexion¶

Client Essensys ne peut pas se connecter¶

Vérifier que Nginx écoute sur le port 80
Vérifier que le backend fonctionne
Vérifier les logs API détaillés
Vérifier le firewall

Frontend ne s'affiche pas¶

Vérifier que les fichiers existent : ls -la /opt/essensys/frontend/dist/
Vérifier les logs Nginx
Vérifier les permissions

Accès WAN ne fonctionne pas¶

Vérifier le NAT/port forwarding
Vérifier le domaine WAN dans /home/essensys/domain.txt
Vérifier les certificats SSL
Vérifier les logs Traefik

Problèmes de ports¶

Port déjà utilisé¶

# Trouver le processus
sudo lsof -i :7070
sudo lsof -i :80
sudo lsof -i :443

# Arrêter le processus
sudo kill <PID>

Conflit entre Nginx et Traefik¶

Nginx et Traefik peuvent coexister sur le port 80 grâce aux server_name différents. Si problème, vérifier la configuration.

Conflit avec Caddy (legacy)¶

Si caddy est encore présent, il peut bloquer :443.

sudo systemctl disable --now caddy
sudo apt-get purge -y caddy
sudo ss -ltnp | grep :443