AI Diagnostic Summary

Error: ETIMEDOUT

Well-Documented Error

This error matches known, documented patterns with reliable solutions.

Quick Fix (Most Common Solution)

Seeing "Error: ETIMEDOUT"? This error can be frustrating, but it's usually fixable. It typically affects your development workflow or system. Below you'll find clear, step-by-step solutions to resolve this issue.

High confidence
What This Error Means

The connection to the remote server took too long and timed out.

Frequently documented in developer and vendor support forums.

Based on documented solutions and common real-world fixes.
Not affiliated with browser, OS, or device manufacturers.

New here? Learn why exact error messages matter →

Common Causes
  • Server is slow or unresponsive
  • Network issues
  • Firewall silently dropping packets
How to Fix
  1. Increase timeout setting
  2. Check network connectivity
  3. Verify server is reachable

Last reviewed: April 2026 How we review solutions

Environment Differences

Cloud Environments Add Latency and Timeout Layers Absent Locally

ETIMEDOUT in cloud environments differs from local behavior in ways that confuse developers who only test locally. Local HTTP connections to external APIs succeed in under 50ms on a fast fiber connection. The same code in a Lambda function, App Engine instance, or Kubernetes pod may time out due to NAT gateway latency, VPC routing overhead, or egress security rules filtering the connection. AWS Lambda has a hard execution timeout (default 3 seconds, max 15 minutes). If your function makes an HTTP request to a slow API and the request exceeds the Lambda timeout, you see ETIMEDOUT with an abrupt process termination rather than the HTTP client's own timeout. This looks like the HTTP client is at fault, but the cause is the Lambda timeout ceiling. Connection pooling is another hidden factor. HTTP/HTTPS agents in Node.js default to 5 sockets per host. Under high concurrency, a burst of requests queues connections that eventually hit the queue timeout — surfaced as ETIMEDOUT even though individual connections to the host succeed. Setting maxSockets: Infinity on the agent (appropriate for short-lived Lambda processes) or increasing it to match your concurrency avoids queue-induced timeouts. The got and axios libraries expose separate connect, response, and overall timeout options that help distinguish which phase is timing out.

Need reliable hosting?

DigitalOcean offers simple cloud infrastructure with $200 free credit for new users.

Try DigitalOcean →

We may earn a commission from tools recommended in our fixes.

Optional follow-up

Some users ask whether saving fixes for recurring errors would be useful when the same issue appears again.

Was this explanation helpful?

Explanations are based on documented fixes, real-world reports, and common system behavior. GetErrorHelp is independent and not affiliated with software vendors, device manufacturers, or service providers.
Frequently Asked Questions

How do I increase timeout?

Set timeout option in HTTP/HTTPS request options.

What is the default timeout?

Node.js HTTP has no default timeout - requests wait indefinitely.

Related Resources

Also Known As

Common Search Variations

Related Errors
Still Stuck?

Paste a different error message or upload a screenshot to get help instantly.

Solutions are based on commonly documented fixes and may not apply in all situations.