Client.Timeout Exceeded Errors

reading time 2 minutes


CLI v3.31.0 Required

The solution recommended in this article requires a CLI version of v3.31.0 and above.

If the Doppler CLI exits with an error message containing Client.Timeout exceeded while awaiting headers, you're likely unable to resolve the IP address of This can be caused by your WiFi router (e.g. Google WiFi), VPNs, proxies, and other network egress restrictions.

To resolve this issue, you can instruct the CLI to use a different DNS resolver than the one provided by your OS. This can be enabled in two ways.

Option 1: Use a Flag

This flag must be specified on every invocation.

doppler run --enable-dns-resolver -- your-app

Option 2: Use an Environment Variable


If you're still experiencing issues, add the --debug flag to your command and get in touch via our Community Forum or our in-product support.


Once enabled, you can configure the DNS resolver with the following flags.

FlagDescriptionDefault value
--dns-resolver-address stringaddress to use for DNS resolution1.1.1.1:53
--dns-resolver-proto stringprotocol to use for DNS resolutionudp
--dns-resolver-timeout durationmax dns lookup duration5s