How to connect to a Redis™ Database Instance

Reviewed on 04 July 2024 • Published on 18 April 2023

You can connect to your Redis™^* Database Instance using the Redis™ CLI.

Before you start

To complete the actions presented below, you must have:

A Scaleway account logged into the console
Owner status or IAM permissions allowing you to perform actions in the intended Organization
A Redis™ Database Instance

Important

To connect to a Redis™ Database Instance in a Private Network, you can use Public Gateways in SSH bastion mode and perform port forwarding, as Managed Databases for Redis™ are currently not compatible with the Static NAT feature of Scaleway Public Gateways.

Click Redis™ under Managed Databases on the side menu. A list of your Redis™ Database Instances displays.
Click the Database Instance name or «See more Icon» > More info to access the Database Instance information page.
Retrieve the Database Instance IP and port from the Database Instance information section.

Note
Alternatively, you can click the copy icon under Connection to retrieve the Redis™ CLI connection command. This already includes an IP and port.

Important
You can use only one of your node IP addresses at a time to connect to your Redis™ Database Instance, as the Redis™ CLI does not support cluster mode.
Run the following command to connect to your Redis™ Database Instance.

Note
In this tutorial we will use 192.0.2.1 and 6379 as the example IP and port, respectively.
```
redis-cli -h 192.0.2.1 -p 6379 --user <redis-user> --askpass --tls --cacert SSL_<redis-cluster-name>.pem
```
Note
The command above uses TLS to add an extra layer of security to your connection. The TLS certificate is generated automatically if you set tls_enabled to true. The certificates take on the following name structure: SSL_redis-<name-of-your-redis-database-instance>.pem. When using connectors other than redis-cli, you might need to specify the path to your certificate.

Important
Scaleway supports TLS1.2 and TLS1.3. If you use older versions of libssl, you might encounter connection issues when using redis-cli. If this is the case, we recommend you check the libssl versions installed on your local machine and update if necessary.
Enter the password that you defined upon database creation.

You are now connected to your Managed Database for Redis™.

^* Redis is a trademark of Redis Labs Ltd. Any rights therein are reserved to Redis Labs Ltd. Any use by Scaleway is for referential purposes only and does not indicate any sponsorship, endorsement or affiliation between Redis and Scaleway.