Redis Enterprise Software quickstart
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:
Ensure port availability
If port 53 is in use, the installation fails. This can occur in
default installations of Ubuntu 18.04 and 20.04 in which
systemd-resolved (DNS server) is running.
To prevent this issue, change the system configuration to make this port available before installation.
sudo vi /etc/systemd/resolved.conf
DNSStubListener=noas the last line in the file and save the file.
Rename the current
sudo mv /etc/resolv.conf /etc/resolv.conf.orig
Create a symbolic link for
sudo ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf
Restart the DNS service:
sudo service systemd-resolved restart
Install Redis Enterprise Software
To install Redis Enterprise Software:
Download the installation files from the Redis Enterprise Download Center and copy the download package to a machine with a Linux-based OS.Note:You are required to create a free account to access the download center.
Extract the installation files:
tar vxf <downloaded tar file name>
install.shscript in the current directory:
sudo ./install.sh -y
Set up a cluster
To set up your machine as a Redis Enterprise Software cluster:
In the web browser on the host machine, go to https://localhost:8443/new to see the new Redis Enterprise Software Cluster Manager UI.
To use the legacy UI for this quickstart instead, see the 6.4 version of the quickstarts.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.
Select Create new cluster.
Enter an email and password for the administrator account, then select Next to proceed to cluster setup.
You can also use these credentials to connect to the REST API.
Enter your cluster license key if you have one. Otherwise, a trial version is installed.
In the Configuration section, enter a cluster FQDN such as
cluster.local, then select Next.
On the node setup screen, select Create cluster.
Select OK to acknowledge the replacement of the HTTPS TLS certificate on the node. If you receive a browser warning, you can proceed safely.
Create a database
On the Databases screen, select Quick database.
Enter 12000 for the Port.
If port 12000 is not available, enter any available port number between 10000 to 19999 or leave it blank to let the cluster assign a port number for you. You will use this port number to connect to the database.
Select Create to create your database.
When you see Database active appear on the database configuration screen, the database is activated and ready for you to use.
You now have a Redis database!
Connect to your database
After you create the Redis database, it is ready for you to store data. See the test connectivity page to learn how to connect to your database.
Supported web browsers
The following browsers have been tested with the current version of the admin console:
Microsoft Windows, version 10 or later.