Website onbereikbaar, 502 Bad Gateway of certificaatfout

De pagina laadt helemaal niet

1. Wijst de naam naar je VPS? dig +short example.com moet je IP-adres geven (zie Een A- en AAAA-record in Mijn Domeinen).
2. Staan 80 en 443 open? sudo ufw status (zie Een firewall met ufw (of nftables)).
3. Draait de webserver? systemctl status caddy of nginx, of sudo docker compose ps in /srv/diensten.
4. Luistert er iets? sudo ss -tlnp | grep -E ':(80|443) '.

502 Bad Gateway

Je webserver werkt, maar krijgt geen antwoord van de app erachter.

• Draait de app? sudo docker compose ps en sudo docker compose logs --tail 50 <app>.
• Klopt de naam en de poort in het Caddyfile of in proxy_pass? Bij Caddy in Docker is dat de servicenaam, zoals uptime-kuma:3001. Bij een webserver buiten Docker is dat 127.0.0.1 met de gepubliceerde poort.
• Start de app nog op? Sommige apps hebben bij de eerste start even nodig. Wacht een minuut.

Geen certificaat of een certificaatfout

• Kijk in de log waarom het aanvragen mislukt: sudo docker compose logs caddy, journalctl -u caddy of de uitvoer van certbot.
• Let's Encrypt controleert via poort 80. Staat poort 80 dicht, of wijst het AAAA-record naar een adres waar niets luistert, dan mislukt de controle.
• Heb je vaak achter elkaar geprobeerd? Dan kun je tegen een limiet van Let's Encrypt zijn aangelopen. Wacht een uur en los eerst de oorzaak op.
• Verloopt het certificaat zonder dat het vernieuwd wordt? Test met sudo certbot renew --dry-run (nginx) of kijk in de log van Caddy.

Te veel doorverwijzingen

De browser meldt dat de pagina te vaak doorverwijst? Vaak denkt de app dat hij op http draait en stuurt hij door naar https, waarna de proxy weer doorstuurt. Controleer of je proxy X-Forwarded-Proto meestuurt (zie Een app achter een reverse proxy) en of het adres in de app met https:// begint.