HTTPS on localhost shows NET::ERR_CERT_AUTHORITY_INVALID — trust a local development certificate (mkcert)
A self-signed certificate for localhost or *.test isn't trusted by the browser, so dev servers show warnings.
NET::ERR_CERT_AUTHORITY_INVALID localhostself signed certificate localhostmkcert localhost HTTPSYour connection isn't private localhost Meaning
Create a locally trusted CA and certificate with mkcert (mkcert -install && mkcert localhost 127.0.0.1 ::1), and point the dev server at the files. Include localhost, 127.0.0.1 and ::1 in the SAN. Chrome's chrome://flags/#allow-insecure-localhost is a last resort.
Common causes
- Self-signed certificate without a trusted root
- Missing SAN for localhost/127.0.0.1
- Browser not restarted after trusting
- Node/Python using their own CA store
- Docker container using another certificate
⚡ Quick fix
mkcert -install && mkcert localhost 127.0.0.1 ::1- Configure the dev server with the key/cert
- Set
NODE_EXTRA_CA_CERTSfor Node tools
Detailed fix by platform
Shell
- bash
mkcert -install mkcert localhost 127.0.0.1 ::1 # vite: server.https = { key, cert }
How to diagnose
- Root — Installed?
- SAN — localhost + IPs?
- Tool — Uses system store?
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
- ACM region CloudFront can't use my ACM certificate: it must be requested in us-east-1 (N. Virginia)
- ALB listener ALB HTTPS listener: CertificateNotFound / default certificate missing or SNI certificate list incomplete
- DEPTH_ZERO_SELF_SIGNED_CERT Node/OpenSSL: Error: self signed certificate (code: DEPTH_ZERO_SELF_SIGNED_CERT)
Most viewed in SSL / TLS
- HTTPSConnectionPool: Max retries exceeded (SSLError) Python requests: HTTPSConnectionPool(host='api.example.com', port=443): Max retries exceeded with url: /v1 (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] ...')))
- DST Root CA X3 expired (old clients fail) Old clients: certificate has expired — Let's Encrypt chain uses expired DST Root CA X3 (OpenSSL 1.0.x, Android < 7.1.1)
- Keystore was tampered with, or password was incorrect Java keytool: java.io.IOException: Keystore was tampered with, or password was incorrect
Other ways to find it
Where this error sits
Origin: Network. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Report a correction or suggest an improvement
Last updated 18 Nov 2026