Error fix
How to fix “ETIMEDOUT — connection timed out”
TCP connection attempts timed out—host unreachable, firewall, or wrong address.
Updated Apr 20, 2026
Tools that help with this
Fastest fix
Start here first. Step 1 fixes most cases—then work down the list.
- Ping/traceroute and test port with nc/telnet from the same environment.
- Check cloud security groups and on-prem firewalls for egress/ingress.
- Validate DNS A/AAAA records and TTL after changes.
Why this works
These steps work because it rules out local security software dropping the connection.
What this means
No response to SYN within the OS timeout—different from refused (actively rejected) or reset.
Common causes
Network path
Firewall rules, security groups, or routing to a dead IP.
DNS to wrong region
Geo DNS points to an unreachable PoP from your network.
Step-by-step fix
Verify reachability
- Ping/traceroute and test port with nc/telnet from the same environment.
- Check cloud security groups and on-prem firewalls for egress/ingress.
- Validate DNS A/AAAA records and TTL after changes.
Related
FAQ
- ETIMEDOUT in Docker?
- Check bridge networking, published ports, and DNS inside the container.
- Intermittent only?
- Suspect flaky Wi‑Fi, MTU issues, or overloaded NAT gateways.
- IPv6 timeout?
- Try disabling AAAA temporarily to see if IPv4 path works.
Fix related issues
Still stuck? Try these related fixes next.
- Docker: no space left on deviceThe daemon or image layers filled the disk—prune images, volumes, or expand the host disk.
- Redis connection refusedRedis isn’t running or you’re pointing at the wrong host/port in this environment.
- Stripe invalid API keyThe key is wrong, revoked, or for a different mode (test vs live).
- SQLite SQLITE_BUSYConcurrent writers or long transactions held the lock—common in dev with hot reload.
- MongoDB server selection timeoutThe driver could not pick a server in time—replica set issues, DNS, or firewall rules.
Edit your error
Tweak the message and run again—we'll match an existing fix or generate a new page.
Original error message
connect ETIMEDOUT