Redis Cloud Connection Timeout

How to fix it

// try these in order, the most common fix is first

1. FIX 1Re-copy endpoint and port

   Copy steps
   1. 01Open the database in the Redis Cloud console
   2. 02Click Connect and copy the public endpoint, host:port
   3. 03Paste it into your client config; do not assume 6379
   Did this fix it? Yes No

2. FIX 2Test from your machine

   Copy steps
   1. 01Run redis-cli -u redis://default:PASSWORD@HOST:PORT ping
   2. 02If it hangs, test the port with nc -vz HOST PORT
   3. 03Try another network to rule out a firewall
   Did this fix it? Yes No

3. FIX 3Set client timeouts and keepalive

   Copy steps
   1. 01Set connectTimeout and socketTimeout to about 5s
   2. 02Enable TCP keepalive
   3. 03Retry with backoff
   Did this fix it? Yes No

Symptoms

Client hangs then throws ETIMEDOUT, ConnectionTimeoutError or 'i/o timeout'.

Why it happens

• C-01Wrong host or port
• C-02Your IP not allowed (Pro/private networks)
• C-03Firewall blocks outbound port
• C-04TLS expected but not enabled
• C-05Idle connections dropped by a NAT/load balancer

// this guide also covers

• redis cloud connection timeout
• redis cloud not connecting
• redis cloud i/o timeout

The same problem in other apps

All not loading, error messages & connection guides →

• Upstash Redis ECONNRESET Error (Upstash)

Other Redis Cloud errors

• Redis Cloud Connection Refused
• Redis Cloud WRONGPASS / NOAUTH Authentication Error
• Redis Cloud SSL / TLS Connection Error
• Redis Cloud OOM command not allowed when used memory > maxmemory
• Redis Cloud ERR max number of clients reached
• Why Is Redis Cloud Slow / High Latency
• Redis Cloud Cannot Connect From My IP (Allowlist / Source IP)
• Redis Cloud Data Lost / Keys Disappeared