nginx ne démarre pas : diagnostiquer en 5 minutes sur Ubuntu
nginx refuse de démarrer ou renvoie une 502 ? Lire systemctl et journalctl, tester la configuration, repérer un port déjà pris ou un certificat manquant.
1. Lire l’état du service
systemctl status donne l’état et les dernières lignes du journal. journalctl détaille l’erreur au moment du démarrage.
systemctl status nginx
journalctl -u nginx -n 50 --no-pager2. Tester la configuration
La majorité des échecs viennent d’une erreur de syntaxe, d’un fichier inclus manquant ou d’un certificat introuvable.
sudo nginx -t3. Vérifier les ports
« Address already in use » signifie qu’un autre processus (Apache, un conteneur, une ancienne instance) écoute déjà sur 80 ou 443.
sudo ss -ltnp | grep -E ':80|:443'4. 502 Bad Gateway : regarder en amont
nginx fonctionne mais l’application derrière ne répond pas : vérifiez le service ou le conteneur cible avant de redémarrer nginx, qui n’y changera rien.