When you install Redis Enterprise Software on the first node of a cluster, you create the new cluster. After you install the first node, you can add more nodes to the cluster.


Before you add a node to the cluster:

  • The clocks on all nodes must always be synchronized.

    If the clock in the node you are trying to join to the cluster is not synchronized with the nodes already in the cluster, the action fails and an error message is shown indicating that you must synchronize the clocks first.

  • You must update the DNS records each time a node is added or replaced.

  • We recommend that you add nodes one after the other rather than in parallel to avoid errors that occur because the connection to the other nodes in the cluster cannot be verified.

To add a node in RS:

  1. Install the RS installation package on a clean installation of a supported operating system.

  2. To connect to the RS management UI of the new RS installation, go to: <https://URL or IP address:8443>

    For example, if you installed RS on a machine with IP address, go to

    Tip -
    The RS management UI uses SSL encryption with a default certificate. You can also replace the TLS certificate with a custom certificate.
  3. To start configuring RS, click Setup.

  4. Configure the RS network and storage settings:

    1. You can enter a path for Persistent storage, or leave the default path.
    2. You can enter a path for Ephemeral storage, or leave the default path.
    3. If you want to enable Redis on Flash, select Enable flash storage support and enter the path to the Flash storage to use as RAM extension.
    4. If your machine has multiple IP addresses, in IP Addresses Usage assign a single IPv4 type address for internal traffic and multiple IPv4/IPv6 type addresses for external traffic.
  5. Join the new RS node to the cluster:

    1. In Cluster configuration, select Join cluster.

    2. Enter the internal IP address or DNS name of a node that is a cluster member.

      If the node only has one IP address, enter that IP address.

    3. Enter the credentials of the cluster administrator.

      The cluster administrator is the user account that you create when you configure the first node in the cluster.

  6. Click Next.

    If the cluster is configured to support rack-zone awareness, you are redirected to a page in which you must set the Rack-zone ID for the new node.

The node is added to the cluster. You can see it in the list of nodes in the cluster.

If you see an error when you add the node, try adding the node again.

Tip -
We recommend that you run the rlcheck utility to verify that the node is functioning properly.