Warning -
Docker containers are currently only supported for development and test environments, not for production.

For testing purposes, you can run Redis Enterprise Software on Docker containers on Linux, Windows, or MacOS. The Redis Enterprise Software container acts as a node in a cluster.

To get started with a single Redis Enterprise Software container:

  1. Install Docker for your operating system

  2. Run the Redis Enterprise Software Docker container

  3. Set up a cluster

  4. Create a new database

  5. Connect to your database

Deployment topologies

When deploying Redis Enterprise Software using Docker, several common topologies are available, according to your requirements:

Single node

The simplest topology is to run a single-node Redis Enterprise Software cluster with a single container on a single host machine. You can use this topology for local development or functional testing.

Single-node clusters have limited functionality. For example, Redis Enterprise Software can’t use replication or protect against failures if the cluster has only one node.


Multiple nodes on one host

You can create a multi-node Redis Enterprise Software cluster by deploying multiple containers to a single host machine. The resulting cluster is scale minimized but similar to production deployments.

However, if you need predictable performance or high availability, don’t host multiple nodes in containers on the same physical host.

Docker Redis Enterprise Software Cluster

Multiple nodes and hosts

You can also create a multi-node Redis Enterprise Software cluster with multiple containers by deploying each container to a different host machine.

This topology minimizes interference between containers, so Redis Enterprise Software performs more predictably than if you host multiple nodes on a single machine.


Install Docker

Follow the Docker installation instructions for your operating system:

Run the container

To download and start the Redis Enterprise Software Docker container, run the following docker run command in the terminal or command line for your operating system.

On Windows, make sure Docker is configured to run Linux-based containers.
docker run -d --cap-add sys_resource --name rp -p 8443:8443 -p 9443:9443 -p 12000:12000 redislabs/redis

The example command runs the Docker container with Redis Enterprise Software on localhost and opens the following ports:

  • Port 8443 for HTTPS connections

  • Port 9443 for REST API connections

  • Port 12000 for Redis client connections

You can publish other ports with -p <host_port>:<container_port> or use the --network host option to open all ports to the host network.

Set up a cluster

  1. In the web browser on the host machine, go to https://localhost:8443/new to see the new Redis Enterprise Software Cluster Manager UI.

    To use the legacy UI for this quickstart instead, see the 6.4 version of the quickstarts.

    • If your browser displays a certificate error, you can safely proceed.
    • If the server does not show the login screen, try again after a few minutes.
  2. Select Create new cluster.

    When you first install Redis Enterprise Software, you need to set up a cluster.
  3. Enter an email and password for the administrator account, then select Next to proceed to cluster setup.

    Set the credentials for your admin user.

    You can also use these credentials to connect to the REST API.

  4. Enter your cluster license key if you have one. Otherwise, a trial version is installed.

    Enter your cluster license key if you have one.
  5. In the Configuration section, enter a cluster FQDN such as cluster.local, then select Next.

    Configure the cluster FQDN.
  6. On the node setup screen, select Create cluster.

  7. Select OK to acknowledge the replacement of the HTTPS TLS certificate on the node. If you receive a browser warning, you can proceed safely.

Create a database

  1. On the Databases screen, select Quick database.

    Select Quick database on the Databases screen.
  2. Enter 12000 for the Port.

    If port 12000 is not available, enter any available port number between 10000 to 19999 or leave it blank to let the cluster assign a port number for you. You will use this port number to connect to the database.

    Create a quick database.
  3. Select Create to create your database.

When you see Database active appear on the database configuration screen, the database is activated and ready for you to use.

Database active icon.

You now have a Redis database!

If you cannot activate the database because of a memory limitation, make sure that Docker has enough memory allocated in the Docker Settings.

Connect to your database

After you create the Redis database, you can start storing data.

You can test connecting to your database with:


You can use the redis-cli command-line tool to interact with your Redis database.

  1. Use docker exec to start an interactive shell session in the Redis Enterprise Software container:

    docker exec -it rp bash
  2. Run redis-cli and provide the port number with -p to connect to the database. Then use SET to store a key and GET to retrieve it.

    $ /opt/redislabs/bin/redis-cli -p 12000> SET key1 123
    OK> GET key1


You can also run a Python application on the host machine to connect to your database.

The following section assumes you already have Python and the Redis Python client redis-py set up on the host machine running the container. For redis-py installation instructions, see the Python client quickstart.
  1. Create a new file called redis_test.py and add the following code:

    import redis
    r = redis.StrictRedis(host='localhost', port=12000, db=0)
    print ("set key1 123")
    print (r.set('key1', '123'))
    print ("get key1")
  2. Run redis_test.py to store a key in your database and then retrieve it:

    $ python redis_test.py
    set key1 123
    get key1

Next steps