In this getting started guide, we take you through the steps to install Redis Enterprise Software (RS) on a Linux host to test its capabilities. The steps to set up a RS cluster with a single node are super simple and go as follows:

  • Step 1: Install Redis Enterprise Software
  • Step 2: Set up a Redis Enterprise Software cluster
  • Step 3: Create a new Redis database
  • Step 4: Connect to your Redis database
This quick start is designed for local testing only. For production environments, the RS installation procedures walk you through all of the deployment options.

You can also try out RS with our guides for:

Step 1: Install Redis Enterprise Software

To get RS installed on your machine:

  1. Download the installation files from the Redis Enterprise Download Center and copy the download package to machine with a Linux-based OS. To untar the image:

    tar vxf <downloaded tar file name>
    You are required to create a free login to access the download center.
  2. Once the tar command completes, install RS with the script in the current directory.

    sudo ./ -y
    Note -
    When port 53 is in use, the installation fails. This is known to happen in default Ubuntu 18.04 installations in which systemd-resolved (DNS server) is running. To workaround this issue, change the system configuration to make this port available before running RS installation.
    Example steps to resolve the port 53 conflict:

Step 2: Set up a cluster

To set up your machine as an RS cluster:

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

    • Depending on your browser, you may see a certificate error. You can safely continue to the web console.
    • If the server does not show the login screen, try again after a few minutes.
  2. Click Setup to start the node configuration steps.

    Redis Enterprise Software Setup

  3. In the Node Configuration settings, enter a cluster FQDN such as cluster.local. Then click Next button.

    Redis Enterprise Software node configuration

  4. Enter your license key, if you have one. If not, click the Next button to use the trial version.

  5. Enter an email and password for the admin account for the web console.

    Redis Enterprise Software admin credentials

    These credentials are also used for connections to the REST API.

  6. Click OK to confirm that you are aware of the replacement of the HTTPS SSL/TLS certificate on the node, and proceed through the browser warning.

Step 3: Create a database

  1. Select “redis database” and the “single region” deployment, and click Next.

    Redis Enterprise Software create database

  2. Enter a database name such as database1 and then select Show Advanced Options.

    Redis Enterprise Software configure new database screen

  3. In Endpoint port number, enter 12000.

  4. Select the Activate button to create your database.

You now have a Redis database!

Step 4: Connect to your database

After you create the Redis database, you are ready to store data in your database. You can test connectivity to your database with:

  • redis-cli - the built-in command-line tool
  • A Hello World application using Python

Connecting using redis-cli

redis-cli is a simple command-line tool to interact with Redis database.

Run redis-cli, located in the /opt/redislabs/bin directory, to connect to port 12000 and store and retrieve a key in database1

$ sudo /opt/redislabs/bin/redis-cli -p 12000> set key1 123
OK> get key1

Connecting using Hello World application in Python

A simple python application running on the host machine, not the container, can also connect to database1.

The following section assumes you already have Python and redis-py (python library for connecting to Redis) configured on the host machine running the container. You can find the instructions to configure redis-py on the github page for redis-py.
  1. Create a new file called with this contents:

    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 the application to store and retrieve a key:


If the connection is successful, the output of the application looks like this:

set key1 123
get key1

Next steps

Now you have a Redis Enterprise cluster ready to go. You can connect to it with a redis client to start loading it with data or you can use the memtier_benchmark Quick Start to check the cluster performance.