Navigateur

« Bad Gateway » (erreur 502)

Grave Quelque chose ne fonctionne pas : à traiter maintenant.

Le message tel qu'il apparaît dans les logs :

Bad Gateway

Ce que ça veut dire

Le reverse proxy a trouvé la règle pour votre adresse, mais l'application derrière ne répond pas.

Pourquoi ça arrive

• L'application démarre encore (Nextcloud, Immich : jusqu'à une minute).
• Le port indiqué au reverse proxy n'est pas celui où l'application écoute.
• L'application et le reverse proxy ne sont pas sur le même réseau Docker.
• L'application plante au démarrage.

Comment corriger

1. Attendez une minute et rechargez. Puis regardez les logs de l'application :

   cd /opt/stacks/<application> && sudo docker compose logs --tail 50

2. Vérifiez le port déclaré (label loadbalancer.server.port ou ligne reverse_proxy de Caddy) par rapport à la documentation de l'application.

Pour aller plus loin

• Diagnostiquer une application qui ne marche pas : la méthode en 6 étapes