Troubleshooting category
Reverse Proxy & SSL
Nginx Proxy Manager checks for upstream reachability, DNS, TLS, and HTTPS verification. Start with the guide below, then use the service page if the symptom needs a remote session.
Nginx Proxy Manager WebSocket 502 After Restart: Check the Upgrade Header
Fix a 502 after restart when your upstream service runs fine on its direct port. Check the WebSocket Upgrade header in Nginx Proxy Manager and verify with a controlled test.
Nginx Proxy Manager Certificate Renewal: When the Browser Still Distrusts It
Certificate exists in NPM but browser shows trust or handshake error. Follow these checks to diagnose the renewal mismatch and restore trust.
Nginx Proxy Manager DNS Challenge Failed: When the Provider Rejects the TXT Record
Certificate issuance stops at DNS validation because your DNS provider never accepts the TXT record. Check API credentials, zone scope, and propagation with a direct query, then roll back safely.
Nginx Proxy Manager HTTPS Redirect Loop: Isolate the Redirect Source
Troubleshoot an Nginx Proxy Manager HTTPS redirect loop by isolating whether NPM or the backend forces the redirect, with a verification test and rollback note.
Certificate Issued but Browser Still Distrusts It: Check the Proxy Host's SSL Tab
Certificate exists in NPM but the browser still shows a trust or handshake error? Check the Proxy Host's SSL tab, confirm the right certificate is selected, and verify with a direct TLS test.
Nginx Proxy Manager 502 After Restart: Verify the Upstream Protocol
After a restart, your Nginx Proxy Manager proxy host returns 502 even though the upstream service runs on its direct port. Check the upstream scheme setting to resolve this specific 502.
Nginx Proxy Manager 502 After Restart: Verify the Upstream Is Actually Listening
Proxy host returns 502 after restart even though the upstream service runs on its direct port. Check the upstream listening address and fix the mismatch.
Nginx Proxy Manager HSTS Redirect: Stop the HTTP/HTTPS Loop
Troubleshoot an nginx proxy manager hsts redirect loop causing too many redirects. Check HSTS headers, force SSL settings, and verify with curl.
Cloudflare DNS API Fails at TXT Validation in Nginx Proxy Manager
Certificate issuance stalls at DNS validation because Cloudflare rejects the TXT record. Check API token permissions, zone ID, and propagation with these steps.
Nginx Proxy Manager SSL Handshake Failed: When the Certificate Exists but the Browser Still Distrusts It
Troubleshoot nginx proxy manager ssl handshake failed when the certificate is issued but the browser still shows a trust error. Step-by-step checks and verification.
Nginx Proxy Manager WebSocket Connection Failed: Fix the Proxy Handshake
Your app loads but its live WebSocket connection closes through Nginx Proxy Manager. Check the proxy host's WebSocket support and upstream headers, then verify with a browser test.
Nginx Proxy Manager Certbot Renewal Failed: A Step-by-Step Diagnosis
Troubleshoot a failed Nginx Proxy Manager certificate renewal with targeted checks, exact result interpretation, a verification test, and a rollback note.
Nginx Proxy Manager Redirect Loop HTTPS: Isolate the Redirect Source
Browser stuck in an HTTP/HTTPS redirect loop behind Nginx Proxy Manager? Follow these checks to isolate the redirect source and restore normal access.
Nginx Proxy Manager Upstream Timeout: Diagnose a Slow but Alive Backend
Troubleshoot nginx proxy manager upstream timeout when your backend is slow but alive. Check proxy timeouts, verify with curl, and roll back safely.
Nginx Proxy Manager Certificate Not Trusted: Check the Proxy Host SSL Binding
Certificate exists in NPM but the browser still distrusts it? Check the proxy host SSL binding, verify with openssl, and roll back safely.
Certificate Renewed but Browser Still Distrusts It? One Check Before You Panic
Certificate renewed in NPM but browser still shows a trust error? Check the served certificate chain and match it to the proxy host before changing anything.
Nginx Proxy Manager 502 After Restart: Verify the Upstream Resolves
Proxy host returns 502 after restart even though your service runs on its direct port. Check upstream hostname resolution inside the NPM container and restore the proxy.
Nginx Proxy Manager DNS Challenge Failed: Fix the TXT Record Rejection
Troubleshoot Nginx Proxy Manager DNS challenge failure when the DNS provider rejects the TXT record. Step-by-step checks, verification, and rollback.
Nginx Proxy Manager WebSocket 502 After Restart: Verify the Upgrade Headers
Proxy host returns 502 after restart even though the upstream service runs on its direct port. Check WebSocket upgrade headers and confirm the fix with a simple test.
Nginx Proxy Manager WebSocket 502: Fix the Live Connection Drop
Fix a WebSocket 502 through Nginx Proxy Manager by checking the upgrade headers, confirming the backend port, and verifying the handshake.
Browser Still Distrusts a Valid NPM Certificate? Diagnose the Upstream First
Browser shows a trust or handshake error even though the certificate exists in Nginx Proxy Manager? Check the upstream service before you touch the certificate.
Nginx Proxy Manager 502 After Restart: Check the Upstream Container Network
Fix a 502 after restarting Nginx Proxy Manager by checking the upstream container network, DNS resolution, and port binding, then verify with curl and roll back if needed.
Nginx Proxy Manager 502 After Restart: Fix the Upstream Port Mismatch
Proxy host returns 502 after restart even though the upstream service runs on its direct port. Check the upstream port and scheme in NPM, then verify with curl.
Nginx Proxy Manager HTTPS Redirect Loop: Break the Cycle with One Check
Stuck in an nginx proxy manager https redirect loop? Learn how to diagnose and fix the HTTP-to-HTTPS bounce with specific checks and a verification test.
Nginx Proxy Manager SSL Certificate Not Working: When the Browser Still Distrusts It
Certificate is issued in NPM but the browser still shows a trust or handshake error. Follow these checks to diagnose and restore trust.
Nginx Proxy Manager 502: Check the Upstream Before the Certificate
A first-pass Nginx Proxy Manager 502 diagnosis that separates upstream reachability, DNS, and certificate problems.