The first thing you need to choose the platform to run Redis Enterprise Software on. If on-premise or in the cloud and you want to install it yourself, you need to download the package. For Amazon AWS, there are other instructions to set up an AMI image. You can also run RS in a Docker container for testing purposes. Navigate to the Redis Labs download page and select one of the following options:

  • Installation package - Click the Download button for the OS you would like to use in order to download the .tar file installation package.
  • AMI - Click the AWS AMI button for the option you would like to use in order to launch an instance on Amazon Web Services (AWS).
  • Docker (For testing purposes only) - Go here for the install guide and skip this page.

Note: If you are using the AMI option or installing the .tar file package on an AWS instance, review the guidelines in Configuration of AWS instances.


  1. If you intend to use Redis on Flash for your databases, be familiar with the specifics of that feature and its set of prerequisites, storage, and considerations.
  2. Disable Linux swap on all nodes to be part of the cluster.
  3. Ensure you have root level access to each node, either directly or via sudo.
  4. 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:

Installation Procedure

If you downloaded the .tar file installation package, install the package on a machine that is one of the nodes in the cluster by performing the following steps:

  1. In the operating system command-line-interface (CLI), also referred to as Terminal, run the cd command to change the location to the directory where you saved the .tar file.
  2. Extract the package by running the following command in the CLI:

    tar vxf <tarfile name>
  3. To initiate the installation in the CLI, run the following command:

    sudo ./

    Note: You must either be the root user or have access to sudo to the root user to run the install process.

  4. During the installation process, enter the requested input each time you are prompted to do so.

  5. After installation has completed successfully

    1. The install finishes up with rlcheck make testing the installation out and confirming the installation passed.

      2017-04-24 10:54:12 [!] Installation is complete!
      2017-04-24 10:54:12 [?] Would you like to run rlcheck to
      verify proper configuration? [Y/N]? Y
      2017-04-24 10:54:15 [$] executing:
      saving to file: /var/opt/redislabs/log/rlcheck.log
      ##### Welcome to RedisLabs Enterprise Cluster settings
      verification utility ####
      Skipping test: verify_bootstrap_status
      Skipping test: verify_processes
      Running test: verify_dmcproxy
      Verifying dmcproxy process...
      Running test: verify_port_range
      Verifying local port range...
      2017-04-24 10:54:15 [!] Please logout and login again to make
      sure all environment changes are applied.
      2017-04-24 10:54:15 [!] Point your browser at the following
      URL to continue:
      2017-04-24 10:54:15 [!] https://<your_ip_here>:8443

      Make sure to save this URL for when you go to configure the cluster.

    2. If you intend to create Redis on Flash enabled databases, you must prepare and format the flash memory. You should run:

      sudo /opt/redislabs/sbin/

      This command finds all the unformatted disks, RAIDs and mounts them under /var/opt/redislabs/flash You can verify the configuration by running:

      sudo lsblk
  6. Open a web browser and go to the Web UI to complete the cluster setup.

Silent Installations

If you would like to automate the installation script, use either of the following methods to perform a "silent" installation that speeds the process:

  1. Run the install script with "-y" as a parameter (i.e. ./ -y), which silently uses "Y" as a default response to all questions. WARNING: By using the -y parameter you fail to see any alerts from the installer to the possible presence of DBs in Sync state. These alerts when in normal mode allow you to stop the upgrade if they find a DB in that state. Check that your DBs are not in this state before possibly using this flag. Otherwise, do not use this feature.
  2. Run the install script with "-c" and an answers file path as parameters (i.e. ./ --c <answers and="" file="" name="" path="">), thereby allowing the installation to use the answers provided in your answers file. Here is sample content for the answers file: systune=yes ntp=no firewall=no rlcheck=yes

Not all questions in can be automated with the answers file. The reason being is we want an admin to see what was detected and consciously agree to do or not to do something. An example is when detects that a shard of a DB is syncing right now. If that situation is detected, the admin needs to knowingly assume the risk of proceeding and not waiting.

Note: While sudo ./ -y or using an answers file does not perform the steps necessary for Redis on Flash or creating a cluster. That part of each node's install still has to be done and potentially automated separately.

Installation questions

During the interactive installation process, there questions asked to understand how much you want the process to try and configure the OS environment for optimal usage by Redis Enterprise. Each question and what they do is below.

Linux Swap

Swap is enabled. Do you want to proceed? [Y/N]?

Due to how Redis Enterprise manages memory on a node, Linux swap should be disabled in the operating system configuration. For more information on why and how to do this, please see Swap in Linux.

Shard is syncing

Under some circumstances, a database shard may be syncing at the time you run the install script.

shard:X of db:Y is now syncing. Do you want to continue the upgrade

This answer cannot be automatically answered 'Y' due to the sensitive nature of the operation it is warning about. An admin must either assume the risk or abort the install/upgrade.

Automatically Tuning the System

Do you want to automatically tune the system for best performance [Y/N]?

The install process can run a script that does environment changes on your behalf. If you answer yes to this question, the install asks more in-depth questions to best optimize the OS environment for running Redis Enterprise.

If you answer no, you manually have to tune the OS for running Redis Enterprise.

It is recommended to answer 'Y' to this question and the remaining questions as they streamline the configuration of the environment.

If you would like to see specifically what is being done, please see /opt/redislabs/sbin/ on the node.

Network Time Configuration

Do you want to set up NTP time synchronization now [Y/N]?

Redis Enterprise requires that all nodes of the cluster have synchronized time. If you do not permit the script to configure this, then you must do this manually. For more information see Syncing Node Clocks.

Firewall Ports

Would you like to open RedisLabs cluster ports on the default firewall zone [Y/N]?

If a firewall is operating on the node the install process is running, the script can configure the firewall to open the correct ports Redis Enterprise requires to operate. If not, you have to open the necessary ports on your own. If you need, there is specific information on RHEL/CentOS firewall configuration.

Final Check

Would you like to run rlcheck to verify proper configuration? [Y/N]?

This runs a final check to make sure everything has been done correctly. It is advisable to answer 'Y' on this. If you would like to see the contents of this script, it is installed to /opt/redislabs/bin/rlcheck on every Redis Enterprise node.

Next Steps

After you install RS, you must create or join a cluster. Then you can:

  1. Create a database
  2. Create an active/active database or CRDB