Skip to main content

Redis Modules in a Docker Container

DEPRECATED

RedisMod has been deprecated and is no longer supported. Please refer to the Getting Started Tutorial for how to use Redis.

Profile picture for Ajeet Raina
Author:
Ajeet Raina, Former Developer Growth Manager at Redis

This simple container image bundles together the latest stable releases of Redis and select Redis modules. This image is based on the official image of Redis from Docker. By default, the container starts with Redis' default configuration and all included modules loaded.

Features included in the container​

Step 1. Install Docker​

To use RedisMod on a local Mac, the first step is to install Docker for your operating system. Run the docker version command in a terminal window to make sure that docker is installed correctly.

 docker version

It should display Docker Engine Server and Client version successfully.

Step 2. Running Redismod Docker container​

 docker run -d -p 6379:6379 redislabs/redismod

Step 3. Connect to Redis database​

You can either use redis-cli or use RedisInsight to connect to Redis database. Let's try using redis-cli as shown below:

 redis-cli

Step 4. Verify if all the Redis modules are getting loaded​

 $ redis-cli
 127.0.0.1:6379> info modules
 # Modules
 module:name=rg,ver=10006,api=1,filters=0,usedby=[],using=[ai],options=[]
 module:name=ai,ver=10002,api=1,filters=0,usedby=[rg],using=[],options=[]
 module:name=timeseries,ver=10408,api=1,filters=0,usedby=[],using=[],options=[]
 module:name=bf,ver=20205,api=1,filters=0,usedby=[],using=[],options=[]
 module:name=graph,ver=20402,api=1,filters=0,usedby=[],using=[],options=[]
 module:name=ReJSON,ver=10007,api=1,filters=0,usedby=[],using=[],options=[]
 module:name=search,ver=20006,api=1,filters=0,usedby=[],using=[],options=[]

Let us test drive Redis Search as discussed below in detail.

We are now ready to insert some data. This example uses movies data stored as Redis Hashes, so let’s insert a couple of movies:

  HSET movies:11002 title "Star Wars: Episode V - The Empire Strikes Back" plot "Luke Skywalker begins Jedi training with Yoda." release_year 1980 genre "Action"
 rating 8.7 votes 1127635
 HSET movies:11003 title "The Godfather" plot "The aging patriarch of an organized crime dynasty transfers control of his empire to his son." release_year 1972
 genre "Drama" rating 9.2 votes 1563839

Your Redis database now contains two Hashes. It is simple to retrieve information using the HMGET command, if you know the key of the movies (movies:11002):

 HMGET movies:11002 title rating

To be able to query the hashes on the field for title, say, or genre, you must first create an index. To create an index, you must define a schema to list the fields and their types that are indexed, and that you can use in your queries.

Use the FT.CREATE command to create an index, as shown here:

 FT.CREATE idx:movies ON hash PREFIX 1 "movies:" SCHEMA title TEXT SORTABLE release_year NUMERIC SORTABLE rating NUMERIC SORTABLE genre TAG SORTABLE

Search the movies in the Redis Search index​

You can now use the FT.SEARCH to search your database, for example, to search all movies sorted by release year:

 FT.SEARCH idx:movies * SORTBY release_year ASC RETURN 2 title release_year

To test drive rest of Redis modules, please visit the links mentioned under "References" section.