Skip to content
MtrXTools

x509: certificate signed by unknown authority

Go doesn't trust the certificate's issuer

Seen in Go (crypto/x509), Docker, Kubernetes tools, Terraform, Helm

Go could not chain the server certificate to a root CA in the system trust store.

Common causes

  • A minimal container image (scratch, distroless or bare Alpine) with no CA certificates installed.
  • A corporate proxy or private CA not in the system store.
  • The server omits its intermediate certificate.

How to fix it

  1. Install CA certificates in the image (apk add ca-certificates, or copy /etc/ssl/certs/ca-certificates.crt into scratch images).
  2. Add your private CA to the system store, or point SSL_CERT_FILE or SSL_CERT_DIR at it.
  3. Fix the server to send the full chain.
Check whether the chain is complete

Got a different message? Paste it into the error explainer.

Related errors

All 32 Languages & runtimes errors