How to Install Redis on cPanel: A Step-by-Step Guide

·7 min read·
WordPress, DevOps, Performance

Introduction to Redis and cPanel

In today’s fast-paced digital world, website speed and performance are paramount. Users expect instant loading times, and search engines like Google heavily favor faster websites. One powerful tool that can significantly boost your website’s performance is Redis.

What is Redis? 🚀

Redis, which stands for REmote DIctionary Server, is an open-source, in-memory data structure store. It can be used as a database, cache, and message broker. Unlike traditional disk-based databases, Redis stores data in RAM, making data retrieval incredibly fast. This makes it an ideal solution for caching frequently accessed data, session management, and real-time analytics.

What is cPanel? 🖥️

cPanel is one of the most popular web hosting control panels, providing a graphical interface and automation tools designed to simplify the process of hosting a website. It allows users to manage their website files, databases, emails, and much more, all from a user-friendly dashboard.

This guide will walk you through the process of installing and configuring Redis on your cPanel-managed server, helping you unlock a new level of speed for your web applications.

Why Install Redis on cPanel?

Integrating Redis with your cPanel hosting offers numerous advantages:

  • Blazing Fast Caching: Redis drastically reduces the time it takes to retrieve data, leading to faster page loads and a smoother user experience.
  • Reduced Database Load: By serving frequently requested data from cache, Redis minimizes direct queries to your main database (like MySQL), freeing up resources.
  • Improved User Experience: Faster websites mean happier users, lower bounce rates, and increased engagement.
  • SEO Benefits: Google prioritizes fast-loading websites. Implementing Redis can positively impact your search engine rankings.
  • Session Management: Redis can efficiently manage user sessions, especially for high-traffic websites.

Prerequisites for Redis Installation

Before you begin, ensure you have the following:

  • Root Access or SSH Access: You will need SSH access to your cPanel server with root privileges or a user with sudo capabilities.
  • WHM Access: While not strictly necessary for the entire process, WHM (WebHost Manager) access can be helpful for server-wide configurations.
  • Basic Linux Command Line Knowledge: Familiarity with basic Linux commands will be beneficial.

Step-by-Step Installation Guide

Follow these steps carefully to install Redis on your cPanel server.

Step 1: Connect to Your Server via SSH

First, you need to connect to your server using an SSH client. You can use PuTTY on Windows or the built-in Terminal on macOS/Linux.

ssh username@your_server_ip

Replace username with your cPanel username (or root if you have direct root access) and your_server_ip with your server’s IP address.

Step 2: Install Redis from EPEL Repository

Redis is often available in the EPEL (Extra Packages for Enterprise Linux) repository. If you don’t have EPEL enabled, you’ll need to install it first.

2.1 Install EPEL Release (if not already installed)

yum install epel-release -y

or for newer systems:

dnf install epel-release -y

2.2 Install Redis Server

Now, you can install the Redis server package:

yum install redis -y

or

dnf install redis -y

Step 3: Configure Redis

After installation, you’ll need to make some basic configurations to the Redis configuration file.

nano /etc/redis.conf

Look for the following lines and modify them as recommended:

  • bind 127.0.0.1: This line ensures Redis only listens for connections from the local machine, which is a good security practice. Keep it as is unless you have a specific reason to change it.
  • protected-mode yes: This should be yes for security.
  • daemonize yes: This ensures Redis runs in the background as a daemon. Make sure this is set to yes.
  • requirepass your_strong_password: (Optional but Highly Recommended) Uncomment this line and set a strong password. Replace your_strong_password with a unique, complex password.requirepass your_strong_password_here

Save the file by pressing Ctrl+X, then Y, and then Enter.

Step 4: Start and Enable Redis Service

Now, start the Redis service and enable it to start automatically on boot.

systemctl start redis
systemctl enable redis

You can check the status of Redis to ensure it’s running correctly:

systemctl status redis

You should see an “active (running)” status.

Step 5: Install Redis PHP Extension (php-redis)

To allow your PHP applications (like WordPress, Magento, etc.) to communicate with Redis, you need to install the php-redis extension.

5.1 Determine Your PHP Version

First, identify the PHP version(s) used by your website. You can do this in cPanel under “Select PHP Version” or by checking your info.php file.

5.2 Install php-redis via PECL or WHM

Using WHM (Recommended for EasyApache 4):

If you are using EasyApache 4 on your cPanel server (which is common), you can install the php-redis extension directly through WHM.

  1. Log in to WHM.
  2. Navigate to Home » Software » EasyApache 4.
  3. Click on the “Customize” button next to your currently installed profile.
  4. Go to the “PHP Extensions” section.
  5. Search for redis and enable the extension for all relevant PHP versions (e.g., ea-php74-php-redis, ea-php80-php-redis, etc.).
  6. Click “Review” and then “Provision” to apply the changes.

Using PECL (Command Line – Advanced):

If you prefer the command line or WHM isn’t an option, you can use PECL. First, ensure you have php-devel and php-pear installed for your PHP version.

Example for PHP 7.4:

# Replace 74 with your PHP version (e.g., 73, 80, 81)
yum install ea-php74-php-devel ea-php74-php-pear -y
/opt/cpanel/ea-php74/root/usr/bin/pecl install redis

After installation, you’ll need to add extension=redis.so to your php.ini file for the respective PHP version.

Step 6: Configure Your Application to Use Redis

This is the final step, where you tell your web application to start using Redis for caching. The method varies depending on your application.

For WordPress:

  1. Install a caching plugin like Redis Object Cache or WP Redis.
  2. After activating the plugin, navigate to its settings.
  3. The plugin will typically detect Redis automatically. If you set a password in redis.conf, you will need to enter it in the plugin settings.
  4. Enable object caching.

For Magento:

Magento 2 has built-in support for Redis. You’ll need to modify your app/etc/env.php file.

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'Cm_Cache_Backend_Redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'port' => '6379',
                'database' => '0',
                // 'password' => 'your_strong_password_here' // Uncomment if you set a password
            ]
        ],
        'page_cache' => [
            'backend' => 'Cm_Cache_Backend_Redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'port' => '6379',
                'database' => '1',
                // 'password' => 'your_strong_password_here' // Uncomment if you set a password
            ]
        ]
    ]
],
'session' => [
    'save' => 'redis',
    'redis' => [
        'host' => '127.0.0.1',
        'port' => '6379',
        'database' => '2',
        'compression_threshold' => '2048',
        'compression_mode' => 'php',
        'dir' => '',
        'protocol' => 'tcp',
        'timeout' => '10',
        'retries' => '5',
        'break_after_frontend' => '5',
        'break_after_adminhtml' => '30',
        'first_lifetime' => '600',
        'bot_first_lifetime' => '60',
        'bot_lifetime' => '7200',
        'disable_locking' => '0',
        'min_lifetime' => '60',
        'max_lifetime' => '2592000',
        'expand_qs' => '0',
        // 'password' => 'your_strong_password_here', // Uncomment if you set a password
        'sentinel_master' => '',
        'sentinel_servers' => '',
    ]
]

Step 7: Verify Redis Functionality

To ensure Redis is working, you can use the redis-cli tool.

redis-cli

If you set a password, you’ll need to authenticate:

AUTH your_strong_password_here
ping

It should respond with PONG. You can also try:

set mykey "Hello Redis"
get mykey

This should return "Hello Redis".

Troubleshooting Common Issues

  • Redis not starting: Check /var/log/redis/redis.log or journalctl -u redis for error messages.
  • PHP extension not loaded: Verify extension=redis.so is in the correct php.ini and restart Apache/LiteSpeed.
  • Connection refused: Ensure Redis is running (systemctl status redis) and no firewall is blocking port 6379.
  • Password issues: Double-check the password in redis.conf and your application’s configuration.

Conclusion

By following this comprehensive guide, you’ve successfully installed and configured Redis on your cPanel server. This powerful caching mechanism will significantly improve your website’s performance, leading to faster loading times, a better user experience, and potentially higher search engine rankings. Regularly monitor your Redis instance and application performance to ensure optimal results.

Ready to see your website fly? Implement Redis today! 🚀

Related Articles

A Guide to the cPanel & WHM Backup Folder Structure
Docker: A Complete Guide for Modern Software Deployment 🐳
Creating cPanel Subdomains and Addon Domains Outside of public_html