How to start using RDM
After you've installed RDM, the first thing you need to do in order to get going is to create a connection to your Redis server. On the main window, press the button labelled Connect to Redis Server.
Connect to a local or public redis-server
On the first tab (Connection Settings), put in general information regarding the connection that you are creating.
- Name - the name of new connection (example: my_local_redis)
- Host - redis-server host (example: localhost)
- Port - redis-server port (example: 6379)
- Password - redis-server authentication password (if any) (http://redis.io/commands/AUTH)
Connect to a public redis-server with SSL
If you want to connect to a redis-server instance with SSL you need to enable SSL on the second tab and provide a public key in PEM format. Instructions for certain cloud services are below:
Windows Azure Redis Cache
- Create a connection with all requested information.
- Make sure that the "Use SSL Protocol" checkbox is enabled.
- Your Azure Redis connection is ready to use.
To connect to a Redis Labs instance with SSL/TLS encryption, follow the steps below:
- Make sure that SSL is enabled for your Redis instance in the Redis Labs dashboard.
- Download and unzip
garantia_credentials.zipfrom the Redis Labs dashboard.
garantia_user.crtin the "Public key" field.
garantia_user_private.keyin the "Private key" field.
garantia_ca.pemin the "Authority" field.
Digital Ocean Managed Redis
Digital Ocean connection settings is a bit confusing. To connect to a Digital Ocean Managed Redis you need to follow steps bellow:
- Copy host, port and password information to RDM
- Leave Username field in RDM empty (Important!)
- Enable SSL/TLS checkox
Connect to private redis-server via SSH tunnel
Basic SSH tunneling
SSH tab is supposed to allow you to use a SSH tunnel. It's useful if your redis-server is not publicly accessible. To use a SSH tunnel select checkbox "Use SSH Tunnel". There are different security options; you can use a plain password or OpenSSH private key.
for Windows users:
Your private key must be in .pem format.
Advanced SSH tunneling
If you need advanced SSH tunneling you should setup a SSH tunnel manually and connect via localhost:
ssh SSH_HOST -L 7000:localhost:6379
How to connect to Redis ElastiCache through EC2
Follow instructions from this blog post
How to connect to Redis ElastiCache with In-Transit Encryption through EC2
Using RDM >=0.9.9
Click on "Enable TLS-over-SSH" in the the SSH connection settings and follow instructions from section How to connect to Redis ElastiCache through EC2
Using RDM <0.9.9
Follow instructions from this documentation section to setup
stunnel on an EC2 instance
After that connect to your Redis ElastiCache through EC2.
Connect to a UNIX socket
socat -v tcp-l:6379,reuseaddr,fork unix:/tmp/redis.sock
Advanced connection settings
The Advanced settings tab allows you to customise the namespace separator and other advanced settings.
Now you can test a connection or create a connection right away.
Congratulations, you've successfully connected to your Redis Server. You should see something similar to what we show above.
Click on the connection and expand keys. By clicking the right button, you can see console menu and manage your connection from there.