Skip to content
MtrXTools

Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: TLS handshake timeout

The TLS handshake with the registry stalled

Seen in docker pull, docker login, docker build, Docker Desktop

The Docker daemon connected to the registry but the TLS handshake did not finish within the timeout.

Common causes

  • A slow, congested or lossy connection, often on Wi-Fi or a VPN.
  • An MTU problem on a VPN or tunnel: small packets pass but the larger handshake packets are dropped.
  • A proxy or firewall inspecting TLS is slow or interfering.

How to fix it

  1. Retry, and try a wired or different network to rule out the local link.
  2. On a VPN, test for an MTU problem and lower the interface MTU if large packets are dropped.
  3. If a proxy is required, configure it for the daemon (systemd drop-in or Docker Desktop proxy settings).

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

Related errors

All 31 Dev tools & SSH errors