A Redis Enterprise Software (RS) cluster typically consists of several nodes. For production deployments, Redis Labs recommends an uneven number of nodes, with a minimum of three.

Note -
In a cluster that consists of only one node, some features and capabilities are not enabled, such as database replication that provides high availability.

To set up a new cluster, you must first install the Redis Enterprise Software package as described in the previous section and then set up the cluster as described below. After the cluster is created you can add multiple nodes to the cluster.

Creating a cluster

To create a cluster:

  1. In a browser, navigate to https://<name or IP address of a machine on which you installed the package>:8443. For example, if you installed RS on a machine with IP address, then navigate to

    Note -
    • The RS management UI uses a self-signed SSL/TLS encryption.
    • If the machine has both an internal IP address and an external IP address, use the external IP address to access the setup UI.
  2. Click Setup.

  3. In the Node Configuration page that appears:

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

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

    3. If you want to enable Redis on Flash, select the Enable flash storage support checkbox and enter the path to the Flash storage. that should be used as RAM extension.

    4. If your machine is configured to have multiple IP addresses, the section IP Addresses Usage is shown. Use the IP Addresses Usage section to assign a single IPv4 type address for internal traffic and multiple IPv4/IPv6 type addresses for external traffic.

    5. In Cluster configuration, select Create new cluster.

    6. In Cluster name (FQDN), enter a unique name for the cluster. For guidelines, refer to How to set the cluster name.

    7. Choose whether to Enable private & public endpoints support.

    8. Choose whether to Enable rack-zone awareness. Enabling rack-zone awareness requires setting the Rack-zone ID for the node.

    9. Click Next.

  4. If you purchased a cluster key, use the Cluster authentication page to enter the key. Otherwise, you get the trial license by default. Read the product Terms and Conditions and click Next.

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

  6. Use the Set admin credentials page to enter the credentials of the cluster administrator. These credentials are required in order to add nodes to the cluster, and to regularly log in to the cluster management UI.

  7. Click Next.

After a short wait, your cluster is created and the cluster management UI appears.

You can now access any of the management capabilities. To create a database, refer to Creating a new database, or add another node to this cluster, refer to Joining a new node to a cluster.

It is highly advisable to verify that the node is functioning properly, by carrying out the following tests: