Step-by-Step Guide to Install Redis

Have a Database Problem? Speak with an Expert for Free
Get Started >>

Introduction

If you’re just getting started with Redis, installing this in-memory data store is the first task you’ll need to accomplish. The steps required for the installation will vary somewhat depending on the operating system you’re using on your local machine. In this article, we’ll provide step-by-step instructions to install Redis on macOS and various distributions of Linux.

Prerequisites

Before you proceed with your Redis installation, make sure you have some experience using the sudo privilege to log into your system. If you’re running Windows or macOS, you can install Redis by clicking on the download link for the interactive installer. Alternatively, you can use Homebrew on macOS to install it. We’ll provide detailed instructions on that process later in our tutorial.

Install Redis on Linux

If you’re using an Ubuntu distribution of Linux, you can install Redis using the APT-GET repository.

First, you’ll need to update the system update manager package. This will ensure that you have the latest version before you attempt to install anything:

1
sudo apt-get update

Using sudo allows you to access the root permissions required for this task.

Next, complete your Redis installation using the install command:

1
sudo apt-get install redis-server

Finally, enable the Redis server with the following command:

1
sudo systemctl enable redis-server

You’ll be prompted for a password for authentication purposes. Input the password and then hit ENTER.

The output of the command will look like this:

1
2
Synchronizing state of redis-server.service with SysV service script with /lib/systemd/systemd-sysv-install.
Executing: /lib/systemd/systemd-sysv-install enable redis-server

If you have a Red Hat distribution of Linux such as CentOS, use the YUM repository to handle your Redis installation by enabling the REMI repository:

1
2
sudo yum install epel-release yum-utils
sudo yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm

Next, enable the config manager package with the following command:

1
sudo yum-config-manager --enable remi

Last but not least, complete the Redis installation using yum:

1
sudo yum install redis

After installing Redis, enable it with the systemctl command:

1
sudo systemctl enable redis

You can also check the status of the Redis database using the sudo system command in the terminal:

1
sudo systemctl status redis

Screenshot of a terminal window returns an active status of a Redis Database service

Install Redis on macOS

If you’re running macOS X on a Mac, you can use the Homebrew package manager for your Redis installation. The following command will download the Homebrew package using cURL and install it with Ruby:

1
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Install Redis using Homebrew

First, update your package manager so it can get the latest version of the Redis database:

1
brew update

Then complete your Redis installation using the command:

1
brew install redis

Enable and start the Redis services

After completing the Redis installation, you’ll want to restart the service:

1
brew services start redis

If you want to run Redis in the background, use the command shown below:

1
redis-server /usr/local/etc/redis.conf

NOTE: This will start the Redis service using the specified configuration file.

The following command will all of the Redis .plist files to the LaunchAgents directory. This causes the service to start automatically whenever Mac OSX is rebooted:

1
ln -sfv /usr/local/opt/redis/*.plist ~/Library/LaunchAgents

Screenshot of Homebrew installing Redis in macOS terminal

Verify Redis is running

The final step in the installation process is to test if the Redis server is running. Connect to the Redis client interface with redis-cli, and then use the ping command to get a response from the server:

1
2
3
4
~$ redis-cli
127.0.0.1:6379> ping
PONG
127.0.0.1:6379>

Conclusion

Installing Redis may seem like an intimidating process if you’re not even sure where to begin. Having step-by-step instructions makes the task a simple one to accomplish. In this article, we showed you how to complete a Redis installation in a variety of environments. With this tutorial to guide you, you’ll be able to handle a Redis installation in any of the major operating systems.

Pilot the ObjectRocket Platform Free!

Try Fully-Managed CockroachDB, Elasticsearch, MongoDB, PostgreSQL (Beta) or Redis.

Get Started

Keep in the know!

Subscribe to our emails and we’ll let you know what’s going on at ObjectRocket. We hate spam and make it easy to unsubscribe.