DEV Community

Gealber Morales
Gealber Morales

Posted on • Originally published at

MOVED error with Redis cluster


In this article I will try to explain a weird error that I had to deal with, working with Redis.
The common message of the error is "(error) MOVED 12933". Now let's
see when this could happened.


In order to follow me you maybe will need to have Redis, I will also assume that you are
using some UNIX like distro, but you could find out the equivalents command on Windows by yourself.
You are a big boy. In total we only need:

  • Redis
  • OS: Ubuntu, Debian, Centos, etc... you got the idea.

Basic setup

Downloading and compiling Redis


The current stable version of Redis is 6.2.6, you could download it
through this link or making use of curl, like this:

curl -sO
Enter fullscreen mode Exit fullscreen mode

Extracting folder

tar -xf redis-6.2.6.tar.gz
Enter fullscreen mode Exit fullscreen mode

Now you should have a folder called redis-6.2.6, let's position inside of it with cd command:

cd redis-6.2.6
Enter fullscreen mode Exit fullscreen mode


Now we are good to go.

Enter fullscreen mode Exit fullscreen mode

In case you want to run the tests inside the redis code, you could run make test. There are other parameters that you can pass in the
build, that could be interesting to trying out, but not now.


In case you are in hurry, let me just summarize it to you. You will find this error when you try to use a redis client on a redis cluster,
without specifying on this redis client that you are actually connecting to a redis cluster and not a normal redis node. Of course, if you just
read this sentence could be the case that it makes no sense to you, right? Let's go deeper then.

Reproducing the error

Let's try to reproduce this error without any particular library in any language first, just making use of redis-cli.


Let's run a Redis cluster locally, it will be easy. If you already compiled the source code of redis in the previous setup, you will
notice that there's a folder called utils. Inside this folder there's another one called create-cluster, so I'm going to make use
of the script inside this folder to create a cluster, is just the easiest way.

In order to run this scrip you need to be position in the same folder as the script, so let's go into there:

cd utils/create-cluster/
Enter fullscreen mode Exit fullscreen mode

Run the script:

./create-cluster start
./create-cluster create
Enter fullscreen mode Exit fullscreen mode

Yes, like that. Wait what? Is already created? Yep, is code written in C so... A little confusing what they mean by start and create, usually the order
is first create and then start, but naming is hard.

In the create command it will ask you Can I set the above configuration? (type 'yes' to accept), so type yes, you are following a
tutorial that's the point.

Now we have our cluster locally running.

How to stop and clean this?

./create-cluster stop
./create-cluster clean
Enter fullscreen mode Exit fullscreen mode


Let's connect to the cluster with redis-cli.
In the previous step you must notice a line like this one in the logs printed on the ./create-cluster create command:

>>> Performing Cluster Check (using node

In my case the port that I will be trying to connect is 30001, but in your case could be any other.

./src/redis-cli -c -p  30001
Enter fullscreen mode Exit fullscreen mode


The -c option is for

-c Enable cluster mode (follow -ASK and -MOVED re-direction).

So right now we are connecting using the cluster mode, so we won't have any problem, the problem will come later
if we try to make operation with a connection that doesn't have this Cluster mode enabled. I'll comment more on that later.

Make a PING command just to check if everything looks fine,> PING
Enter fullscreen mode Exit fullscreen mode

You should get PONG as an answer.

Reproducing error

Now let's back to business ), I will set several pairs and later I will try to fetch them> SET name Lola
-> Redirected to slot [5798] located at
OK> SET name1 Lola
-> Redirected to slot [12933] located at
OK> SET name2 Manolo
-> Redirected to slot [742] located at
OK> SET name3 Juan
OK> SET name4 Juan
-> Redirected to slot [8736] located at
Enter fullscreen mode Exit fullscreen mode

Take a look at these logs, yes I'm connected to port 30001 but my pairs, not always were set at that node. In my case
the value for key name1, on command SET name1 Lola was located in a slot in node 30003. I will explain more in advance, for now let's just
reproduce the error.

Connecting without cluster mode enabled

Let's try to connect to one of this node without enabling cluster mode, so open another terminal and run a this command:

./src/redis-cli -p 30001
Enter fullscreen mode Exit fullscreen mode


Here the difference is that the option -c was not supplied.

Let's make PING, can we? Yes, we can!> PING
Enter fullscreen mode Exit fullscreen mode


Now comes the cool surprise, at the moment you must be thinking like,
"Well I just made PING without problem, so I'm sure that I could retrieve those that I already pushed, right?"

Let's try to retrieve them with GET command,> GET name1
Enter fullscreen mode Exit fullscreen mode

ERROR> GET name1
(error) MOVED 12933> 
Enter fullscreen mode Exit fullscreen mode

Enjoy debugging this on your application, is not fun at all really. You start thinking, like, why? I ran the magical command called PING and
everything is fine.

Just to clarify, this is NOT an error of the server, this is YOUR FAULT, for setting up bad your redis client.

Rule of thumb

In general if you are using a redis cluster in your server, you should enabled the cluster mode on your client. There's a lot of alternatives
for this, depending on the Programming Language that you are using. Here is a list from the redis website:

  • redis-rb-cluster is a Ruby implementation written by me (@antirez) as a reference for other languages. It is a simple wrapper around the original redis-rb, implementing the minimal semantics to talk with the cluster efficiently.
  • redis-py-cluster A port of redis-rb-cluster to Python. Supports majority of redis-py functionality. Is in active development.
  • The popular Predis has support for Redis Cluster, the support was recently updated and is in active development.
  • The most used Java client, Jedis recently added support for Redis Cluster, see the Jedis Cluster section in the project README.
  • StackExchange.Redis offers support for C# (and should work fine with most .NET languages; VB, F#, etc)
  • thunk-redis offers support for Node.js and io.js, it is a thunk/promise-based redis client with pipelining and cluster.
  • redis-go-cluster is an implementation of Redis Cluster for the Go language using the Redigo library client as the base client. Implements MGET/MSET via result aggregation.
  • ioredis is a popular Node.js client, providing a robust support for Redis Cluster.
  • The redis-cli utility implements basic cluster support when started with the -c switch.

Related to Golang, the library go-redis, have also support for this.


  1. Redis cluster tutorial
  2. Redis cluster specification
  3. Cluster Nodes

Until next error guys ).

Top comments (0)