Add a cluster node

Add a node to your existing Redis Enterprise cluster.

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 to an existing cluster:

  1. Install the Redis Enterprise Software installation package on a clean installation of a supported operating system.

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

    For example, if you installed Redis Enterprise Software on a machine with IP address, go to

    The management UI uses TLS encryption with a default certificate. You can also replace the TLS certificate with a custom certificate.
  3. Select Join cluster.

  4. For Cluster identification, 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.

  5. For Cluster sign in, 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.

  7. Configure storage and network settings:

    1. Enter a path for Ephemeral storage, or leave the default path.

    2. Enter a path for Persistent storage, or leave the default path.

    3. To enable Auto Tiering, select Enable flash storage and enter the path to the flash storage.

    4. If the cluster is configured to support rack-zone awareness, set the Rack-zone ID for the new node.

    5. If your machine has multiple IP addresses, assign a single IPv4 type address for Node-to-node communication (internal traffic) and multiple IPv4/IPv6 type addresses for External traffic.

  8. Select Join cluster.

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.

We recommend that you run the rlcheck utility to verify that the node is functioning properly.
Back to top ↑