// troubleshooting guide · upstash

Upstash Redis ECONNRESET Error

Status
Workaround available
platforms:
Node.js (ioredis), Python, Ruby, Fly.io
updated:
November 15, 2026
reports:
3
Method
how we research
Share

RUNBOOK · upstash/econnreset4 FIXES

// quick answer

Upstash databases require TLS. ECONNRESET with ioredis or another TCP client almost always means the client is connecting without TLS: use a rediss:// URL copied from the Console's TCP tab.

Most likely fix: Switch to a TLS URL

How to fix it

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

  1. FIX 1Switch to a TLS URL

    1. 01Open the Upstash Console > your database > Connect
    2. 02Select the TCP tab and copy the connection string
    3. 03Make sure it starts with rediss:// (two s's) and update REDIS_URL
    Did this fix it?
  2. FIX 2Enable TLS in the client

    1. 01ioredis: pass the rediss:// URL or set tls: {} in options
    2. 02redis-py: use ssl=True or a rediss:// URL
    3. 03Ruby redis gem: use rediss:// or ssl: true
    Did this fix it?
  3. FIX 3Handle idle disconnects

    1. 01Add an error listener so ioredis reconnects instead of crashing
    2. 02In serverless, create the client inside the handler and call quit() at the end
    Did this fix it?
  4. FIX 4Use the REST client in serverless

    1. 01Install @upstash/redis and connect with UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN
    2. 02HTTP requests have no long-lived connection to reset
    Did this fix it?

Symptoms

'[ioredis] Unhandled error event: Error: read ECONNRESET' or 'Connection lost (ECONNRESET)' (Redis::ConnectionError in Ruby) right after connecting, or repeatedly in logs.

Why it happens

  • C-01Connection URL starts with redis:// instead of rediss://
  • C-02TLS disabled in client options
  • C-03Wrong host/port copied
  • C-04Idle connections closed by the server or platform (serverless freezes)

// this guide also covers

  • upstash econnreset
  • ioredis econnreset upstash
  • upstash redis connection lost
  • upstash connection reset

Still not working?

If Upstash keeps failing, you're not alone. See every Upstash problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch Upstash Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Upstash errors

All 11 Upstash errors and fixes →