Troubleshooting guide

Nginx Proxy Manager SSL Handshake Failed: When the Certificate Exists but the Browser Still Distrusts It

Category: Reverse Proxy & SSL

You have a certificate issued in Nginx Proxy Manager, but your browser still shows a trust or handshake error, and you are stuck before a controlled diagnosis.

Check the certificate chain and hostname match

Open the certificate in NPM and confirm the domain names listed exactly match the URL you are testing, including any subdomain. A certificate for example.com will not satisfy www.example.com. Next, inspect the certificate details in your browser: if the issuer is unknown or the chain is incomplete, the browser will reject it even though NPM shows it as issued. Compare the certificate’s not-before and not-after dates with your system clock; a clock skew of even a few minutes can cause a handshake failure.

Test with a clean TLS client

From a terminal outside your browser, run: openssl s_client -connect yourdomain.com:443 -servername yourdomain.com -showcerts. Look for ‘Verify return code: 0 (ok)’. If you see ‘unable to get local issuer certificate’ or a hostname mismatch, the problem is the chain or the name, not NPM’s issuance. If the handshake fails entirely, confirm port 443 is reachable and that the proxy host is enabled and pointing to the correct certificate.

Rollback and recovery

If you recently changed the certificate or proxy host settings, revert to the previous working certificate in NPM and re-test. Keep a note of the original configuration so you can restore it if a new chain breaks trust.

If these checks do not resolve your nginx proxy manager ssl handshake failed error,

A laptop displaying proxy host settings and a browser HTTPS test

Ask for help with your openssl output and certificate details.


Back to the service page · Ask about this exact symptom