How to configure WordPress to use Redis

This article describes how to configure WordPress to use Redis.

Redis is an open-source memory object caching system that web sites can use to help accelerate page load times. Redis works by caching in RAM frequently accessed data, such as the results of API calls, database queries, and more. It is frequently used as an alternative to memcached, another caching system.

By adding Redis caching to WordPress, you can help improve your site's performance and page load times.

WordPress plugin support for Redis

There are several plugins available for integrating Redis caching with WordPress. This article describes how to do so with two of the most popular Redis plugins, Redis Object Cache and WP Redis.

You can use whichever plugin you prefer (and you should only use one of these plugins at a time, not simultaneously). With Redis Object Cache, you can do all configuration through the WordPress UI. For WP Redis, you use the command line to complete the configuration.

Option #1: Redis Object Cache plugin

The Redis Object Cache plugin enables you to easily set up your WordPress site to use Redis.

To install and configure Redis Object Cache on your WordPress site, follow these steps: 

1. Log in to WordPress as the administrator.
2. On the Dashboard in the left sidebar, click Plugins, and then click Add New:

   

3. On the Add Plugins page, in the Search plugins text box, type redis object cache and then press Enter.

4. Locate the Redis Object Cache section, and then click Install Now:
   

   

5. When installation is complete, click Activate. The Redis Object Cache page appears:
   

   

6. Configure the plugin:
   

   • If you have a Managed VPS or Dedicated Server, click Enable Object Cache. When you see green checkmarks for Status, Drop-in, and Filesystem, Redis is activated and running for WordPress:

     

   • If you have a Turbo shared or reseller account, follow these steps:
     

     1. In the directory where you installed WordPress, use your preferred text editor to open the wp-config.php file. Just above the /* “That's all, stop editing! Happy publishing. */ line near the end of the file, paste the following text:

        define( 'WP_REDIS_SCHEME', 'unix');
        define( 'WP_REDIS_PATH', '/home/username/.redis/redis.sock');
        

     2. Replace username with your own account username.
     3. Save your changes to the wp-config.php file.
     4. In WordPress, on the Redis Object Cache page, click Enable Object Cache. When you see green checkmarks for Status, Drop-in, and Filesystem, Redis is activated and running for WordPress.

7. You do not need to do anything further to take advantage of performance improvements from Redis caching. The following options are available:
   

   • To view statistics about Redis caching on your site, click the Metrics tab.
   • To view detailed configuration and debugging information, click the Diagnostics tab.
   • To flush the Redis cache, click Flush Cache.
   • To disable Redis caching, click Disable Object Cache.

Option #2: WP Redis plugin

To install and configure WP Redis on your WordPress site, follow these steps: 

1. Log in to WordPress as the administrator.
2. On the Dashboard in the left sidebar, click Plugins, and then click Add New:

   

3. On the Add Plugins page, in the Search plugins text box, type wp redis and then press Enter.

4. Locate the WP Redis section, and then click Install Now:
   

   

5. When installation is complete, click Activate.
6. Log in to your account using SSH.
7. At the command prompt, change to the directory where you installed WordPress. If you have a Managed VPS or Dedicated Server, go to step 9.

8. If you have a Turbo shared or reseller account, follow these steps:
   

   • In the directory where you installed WordPress, use your preferred text editor to open the wp-config.php file. Just above the /* “That's all, stop editing! Happy publishing. */ line near the end of the file, paste the following text:

     $redis_server = array(
         'host' => '/home/username/.redis/redis.sock',
     );
     

   • Replace username with your own account username.
   • Save your changes to the wp-config.php file, and then go to step 9.

9. To enable the object cache, type the following command:
   

   wp redis enable

10. You do not need to do anything further to take advantage of performance improvements from Redis caching. To view status information about the object cache, type the following command:
    

    wp redis info

    To list all of the keys in the object cache, type the following command:
    

    redis-cli KEYS '*'

    To clear the entire cache at once, type the following command:

    redis-cli FLUSHALL

More Information

• For more information about Redis, please visit https://redis.io.
• To view the official WordPress documentation, please visit https://codex.wordpress.org.