Client.Timeout Exceeded Errors

📘

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 api.doppler.com. 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

export DOPPLER_ENABLE_DNS_RESOLVER="true"

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.

Configuration

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