Build and run Redis Community Edition 8 on Ubuntu 20.04 (Focal)
Redis Community Edition |
---|
Follow the steps below to build and run Redis Community Edition 8 from its source code on a system running Ubuntu 20.04 (Focal).
Docker images used to produce these build notes:
- ubuntu:20.04
1. Install required dependencies
Update your package lists and install the necessary development tools and libraries:
apt-get update
apt-get install -y sudo
sudo apt-get install -y --no-install-recommends \
ca-certificates \
wget \
dpkg-dev \
gcc \
g++ \
libc6-dev \
libssl-dev \
make \
git \
python3 \
python3-pip \
python3-venv \
python3-dev \
unzip \
rsync \
clang \
automake \
autoconf \
gcc-10 \
g++-10 \
libtool
2. Use GCC 10 as the default compiler
Update the system's default compiler to GCC 10:
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-10 100 --slave /usr/bin/g++ g++ /usr/bin/g++-10
3. Install CMake
Install CMake using pip3
and link it for system-wide access.
pip3 install cmake==3.31.6
sudo ln -sf /usr/local/bin/cmake /usr/bin/cmake
cmake --version
4. Download and extract the Redis source
The Redis source code is available from the Redis GitHub site. Select the release you want to build and then select the .tar.gz file from the Assets drop down menu. You can verify the integrity of these downloads by checking them against the digests in the redis-hashes GitHub repository.
Copy the tar(1) file to /usr/src
.
Alternatively, you can download the file directly using the wget
command, as shown below.
cd /usr/src
wget -O redis-<version>.tar.gz https://github.com/redis/redis/archive/refs/tags/<version>.tar.gz
Replace <version>
with the three-digit Redis release number, for example 8.0.0
.
Extract the source:
cd /usr/src
tar xvf redis-<version>.tar.gz
rm redis-<version>.tar.gz
5. Build Redis
Set the necessary environment variables and compile Redis:
cd /usr/src/redis-<version>
export BUILD_TLS=yes
export BUILD_WITH_MODULES=yes
export INSTALL_RUST_TOOLCHAIN=yes
export DISABLE_WERRORS=yes
make -j "$(nproc)" all
6. (Optional) Verify the installation
Confirm the Redis installation:
./src/redis-server --version
./src/redis-cli --version
7. Start Redis
To start Redis, use the following command:
./src/redis-server redis-full.conf
To validate that the available modules have been installed, run the [INFO
]/docs/latest/commands/info/ command and look for lines similar to the following:
./src/redis-cli INFO
...
# Modules
module:name=ReJSON,ver=20803,api=1,filters=0,usedby=[search],using=[],options=[handle-io-errors]
module:name=search,ver=21005,api=1,filters=0,usedby=[],using=[ReJSON],options=[handle-io-errors]
module:name=bf,ver=20802,api=1,filters=0,usedby=[],using=[],options=[]
module:name=timeseries,ver=11202,api=1,filters=0,usedby=[],using=[],options=[handle-io-errors]
module:name=RedisCompat,ver=1,api=1,filters=0,usedby=[],using=[],options=[]
module:name=vectorset,ver=1,api=1,filters=0,usedby=[],using=[],options=[]
...
8. (Optional) Install Redis to its default location
cd /usr/src/redis-<version>
sudo make install