// troubleshooting guide · redis cloud

Redis Cloud SSL / TLS Connection Error

Status
Ongoing
platforms:
All clients
updated:
November 15, 2026
reports:
3
Method
how we research
Share

RUNBOOK · redis-cloud/ssl-tls-error2 FIXES

// quick answer

Free and Essentials endpoints are plain by default; TLS must be enabled on the database and the client must use rediss:// and trust the CA. Mismatch causes handshake or EOF errors.

Most likely fix: Match TLS on both sides

How to fix it

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

  1. FIX 1Match TLS on both sides

    1. 01Check Security > TLS on the database
    2. 02Use rediss:// only if TLS is on, redis:// otherwise
    3. 03Download the server CA from the console if required
    Did this fix it?
  2. FIX 2Update your client

    1. 01Upgrade redis-py, node-redis or Jedis to the current release
    2. 02Retest with redis-cli --tls
    Did this fix it?

Symptoms

'SSL: WRONG_VERSION_NUMBER', 'ECONNRESET', 'Connection closed' right after connect.

Why it happens

  • C-01Client uses TLS but database does not (or reverse)
  • C-02Missing CA certificate
  • C-03Using rediss:// against a non-TLS port

// this guide also covers

  • redis cloud ssl error
  • redis cloud tls connection
  • redis wrong_version_number

Still not working?

If Redis Cloud keeps failing, you're not alone. See every Redis Cloud 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 Redis Cloud 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 Redis Cloud errors

All 11 Redis Cloud errors and fixes →