redislabs/redis

Supported Tags

• 8.0.2-41,
• 7.22.2-41,
• 7.22.0-241,
• 7.8.6-13,
• 7.8.4-95,
• 7.8.2-60,
• 7.4.6-275,
• 7.2.4-122,
• 6.4.2-121,
• 6.4.2-61,
• 6.2.18-71,
• 6.2.12-82,
• 6.2.12-68,
• 6.2.10-129,
• 6.2.8-64,
• 6.2.4-54,
• 6.0.20-97,
• 6.0.20-95,
• 6.0.20-69,
• 6.0.12-58,
• 6.0.8-30,
• 6.0.6-39,
• 5.6.0-31,
• 5.4.14-34,
• 5.4.10-22,
• 5.4.6-17,
• 5.4.4-7,
• 5.4.2-27,
• 5.4.0-19,
• 5.2.2-24,
• 5.2.0-14,
• 5.0.2-30,
• 5.0.0-31,
• 4.5.0-51

Preview Versions

https://travis-ci.org/RedisLabs/DockerHub.svg?branch=master](https://travis-ci.org/RedisLabs/DockerHub)

What is Redis Enterprise Software (RS)?

Redis Enterprise Software is enterprise grade, distributed, in-memory NoSQL database server, fully compatible with open source Redis by Redis Labs. Redis Enterprise Software extends open source Redis and delivers stable high performance, zero-downtime linear scaling and high availability, with significant operational savings.

!https://raw.githubusercontent.com/RedisLabs/DockerHub/master/pictures/general/redis_arch.jpeg

• Redis Enterprise Software can use both RAM and Flash drives such as SSDs for data processing. See Redis on Flash) for details.
• Redis Enterprise Software can also support active-active geo-distributed applications with Redis CRDTs
• Redis Enterprise Software supports Redis Modules. See details at RediSearch, ReJSON and ReBloom

Quick Start

1. Run the Redis Enterprise container

docker run -d --cap-add sys_resource --name rp -p 8443:8443 -p 9443:9443 -p 12000:12000 redislabs/redis

2. Configure Redis Enterprise cluster using the "rladmin" tool and "create cluster" command

docker exec -d --privileged rp "/opt/redislabs/bin/rladmin" cluster create name cluster.local username cihan@redislabs.com password redislabs123

3. Create a database on Redis Enterprise cluster

curl -k -u "cihan@redislabs.com:redislabs123" --request POST --url "https://localhost:9443/v1/bdbs" --header 'content-type: application/json' --data '{"name":"db1","type":"redis","memory_size":102400,"port":12000}'

Note: Redis Enterprise may take a few seconds to start depending on your HW. if you receive the following message: "503 Service Unavailable", wait a few more seconds and repeat step-2 and step3 again.

4. Connect to Redis database in Redis Enterprise cluster using "redis-cli"

docker  exec -it rp bash

# sudo /opt/redislabs/bin/redis-cli -p 12000
# 127.0.0.1:16653> set key1 123
# OK
# 127.0.0.1:16653> get key1
# "123"
#

Step-by-Step Guide

You can run the Redis Enterprise Software linux based container on MacOS, various Linux and Windows based machines with Docker. Each Redis Enterprise Software container runs a cluster node. To get started, you can simply set up a one node cluster, create a database and connect your application to the database.

Note: Redis Enterprise Software Docker image works best when you provide a minimum of 2 cores and 6GB ram per container. You can find additional minimum hardware and software requirements for Redis Enterprise Software in the product documentation

1. Run Redis Enterprise Software container

Port 8443 is used for the administration UI and port *** is reserved for the Redis database that will be created in Step #5 below.

docker run -d --cap-add sys_resource --name rp -p 8443:8443 -p 12000:12000 redislabs/redis

2. Setup Redis Enterprise Software by visiting https://localhost:8443 on the host machine to see the RS Web Console

Note: You may see a certificate error with your browser. Simply choose "continue to the website" to get to the setup screen.

!https://raw.githubusercontent.com/RedisLabs/DockerHub/master/pictures/mac/RP-SetupScreen.jpeg

3. Go with default settings and provide a cluster FQDN: "cluster.local"

!https://raw.githubusercontent.com/RedisLabs/DockerHub/master/pictures/mac/RP-SetupScreen2.jpeg

4. Configure free trial & set up cluster admin account

If you don't have a license key, click "Next" to skip the license key screen to try the free version of the product. On the next screen, set up a cluster admin email and password.

!https://raw.githubusercontent.com/RedisLabs/DockerHub/master/pictures/mac/RP-SetupScreen4.jpeg

5. Choose the new redis db option

In the new redis db screen, click the "show advanced option" link and provide a database name "database1", endpoint port number of "***" and click "Activate" to create your database.

!https://raw.githubusercontent.com/RedisLabs/DockerHub/master/pictures/mac/RP-DBScreen2.jpeg

You now have a Redis database!

Connecting to the Redis Database

With the Redis database created, you are ready to connect to your database to store data. You can use redis-cli or your favorite language with Redis client driver to talk to the new database. There is a python based example below.

• Connect using redis-cli:

redis-cli is a simple commandline tool to interact with a Redis instance. Use the following script to connect to the Redis Enterprise Software container, run redis-cli connecting to port *** and store and retrieve a key.

docker  exec -it rp bash

# sudo /opt/redislabs/bin/redis-cli -p 12000
# 127.0.0.1:16653> set key1 123
# OK
# 127.0.0.1:16653> get key1
# "123"
#

• Connect using a Simple Python App:

If you don't have CODE_TOKEN_13 or CODE_TOKEN_14 (python library for connecting to Redis) on the host, you can run the https://hub.docker.com/r/redislabs/redis-py/.

Following section assumes you already have CODE_TOKEN_15 and CODE_TOKEN_16 configured on the host machine running the container.

You can find the instructions to install redis-py on the https://github.com/andymccurdy/redis-py.

Paste the following into a file named CODE_TOKEN_17

CODE_TOKEN_18`

Run redis_test.py application to connect to the database and store and retrieve a key.

CODE_TOKEN_20`

The output should look like the following screen if the connection is successful.

# set key1 123
# True
# get key1
# b'123'

Quick Reference

Supported Docker Versions:

Docker version 17.x or greater.

Getting Started

• Working with Redis Enterprise Software and Docker
• Getting Started with Redis Enterprise Software and Docker on Windows,
• Getting Started with Redis Enterprise Software and Docker on Mac OSx,
• Getting Started with Redis Enterprise Software and Docker on Linux
• Getting Started with Redis on Flash Databases
• Getting Started with Redis CRDTs

Detailed Documentation

• Setting up a Redis Enterprise Software Cluster for Production Use
• Technical Documentation
• How To Guides