Connecting to your Redis Cloud database

Connect quickly and securely by following a concise workflow that covers credential gathering, multiple connection methods (Redis Insight, redis-cli, and client libraries), and troubleshooting tips for the most common issues. Inline notes flag the best places for screenshots or code blocks so you can enhance the article visually later.

Prerequisites

Active Redis Cloud account
• At least one database created in your subscription

Console access
• Needed to view configuration and security details

Network access
• Ensure your IP or CIDR is allow-listed, or set up VPC Peering if you're using private connectivity

Step-by-Step Connection Guide

Gather Connection Credentials

In the Redis Cloud Console, open Configuration for your target database.
Navigate to Security → Password, and click the eye icon to unmask the password for the default user.
If Role-Based Access Control (RBAC) is enabled and the default user is disabled, use your custom username and password instead.

For a deeper walk through, the Manage Databases guide shows additional examples.

Launch the Connection Wizard

From the database list, click Connect next to the endpoint. This opens a wizard that generates ready-to-use connection strings for multiple environments.

Choose a Connection Method

Redis Insight

• Browser: Select Launch Redis Insight Web. This option is available for most Redis Cloud Essentials and Pro databases.
• Desktop: If not installed, click Download to get the Redis Insight desktop client. Once open, create a new connection by entering your host, port, username, and password.

Need help? Refer to the Redis Insight documentation for detailed usage instructions.

redis-cli

If you don’t already have redis-cli, install Redis Stack locally. Then copy the CLI command from the wizard, replacing <username> and <password> with your actual credentials:

redis-cli -u redis://<username>:<password>@<host>:<port>

The Redis Cloud Quick Start also covers the CLI method and initial setup tips.

Programming Language Clients

The wizard also provides ready-made connection code for common programming languages like Python, Node.js, Java, Go, .NET, and PHP.

Update the placeholders with your actual credentials and Redis Cloud endpoint:

import redis

r = redis.Redis(
    host='your-db-host.redis.cloud',
    port=12345,
    username='default',  # or your custom user
    password='your-password',
    ssl=True
)

if r.ping():
    print("Connected to Redis!")

Note: If your DB is not using TLS/SSL do not include ssl=true flag.

For more context on language-specific SDKs, review the guide linked above.

Troubleshooting Common Connection Issues

Connection Refused / Timeout

• Ensure your client IP or CIDR is allow-listed in the Redis Cloud console.
• For cloud deployments with dynamic IPs, add the outbound IP range or configure VPC Peering for stable private networking.

Authentication Failure

• Double-check your username and password (they are case-sensitive).
• If using RBAC, verify that the role has permission to access the database.

TLS/SSL Errors

• Redis Cloud databases enforce encrypted connections. Use the rediss:// URI format or explicitly enable SSL/TLS in your client config.
• TLS is available only for paid subscriptions.
• For configuration help, see Secure Your Redis Cloud Database

Environment Mismatch (Local vs Prod)

• Allow-list both your local machine and your deployment infrastructure if they operate from different IP ranges.

Onboarding Progress

Previous: Choosing a Subscription and Creating Your First Database
Next: Managing Team Members and Roles

You can return to the Redis Cloud Onboarding Overview at any time to track your progress or revisit earlier steps.