This guide helps you install Redis Enterprise Software on a Linux host to test its capabilities.

When finished, you’ll have a simple cluster with a single node:

  • 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
Note:
This quick start is designed for local testing only. For production environments, the install and setup guide walks through deployment options appropriate for a production environment.

Quick start guides are also available to help you:

Step 1: Install Redis Enterprise Software

To install Redis Enterprise Software:

  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>
    
    Note:
    You are required to create a free login to access the download center.
  2. Once the tar command completes, run the install.sh script in the current directory.

    sudo ./install.sh -y
    

Port availability

If port 53 is in use, the installation fails. This is known to happen in default Ubuntu 18.04 installations where systemd-resolved (DNS server) is running. To workaround this issue, change the system configuration to make this port available before installing Redis Enterprise Software.

Here’s one way to do so:

  1. Run: sudo vi /etc/systemd/resolved.conf
  2. Add DNSStubListener=no as the last line in the file and save the file.
  3. Run: sudo mv /etc/resolv.conf /etc/resolv.conf.orig
  4. Run: sudo ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf
  5. Run: sudo service systemd-resolved restart

Step 2: Set up a cluster

To set up your machine as a Redis Enterprise software cluster:

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

    Note:
    • If your browser displays a certificate error, you can safely proceed.
    • If the server does not show the login screen, try again after a few minutes.
  2. Choose Setup to begin configuring the node.

    When you first install Redis Enterprise Software, you need to set up a cluster.
  3. In the Node Configuration settings, enter a cluster FQDN such as `cluster.local' and then select Next.

    When you first install Redis Enterprise Software, you need to set up a cluster.
  4. If you have a license key, enter it and then select Next.

    If you do not have a license key, a trial version is installed.

  5. Enter an email and password for the administrator account.

    Set the credentials for your admin user.

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

  6. Select OK to acknowledge the replacement of the HTTPS TLS certificate on the node. If you receive a browser warning, you can proceed safely.

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. See test connectivity page for a tutorial on connecting to your database.

Supported web browsers

To use the Redis Software admin console, you need a modern browser with JavaScript enabled.

The following browsers have been tested with the current version of the admin console:

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.