There are two options for using Redis with Drupal on, you can either use the PhpRedis extension or the Predis library. PhpRedis requires a PHP extension and should therefore be faster in most situations. Predis is written entirely in PHP and so would require no PHP extension to install locally, but at the cost of some performance.

If you are unsure which to use, we recommend using PhpRedis.


Add a Redis service 

First you need to create a Redis service. In your .platform/services.yaml file, add or uncomment the following:

    type: redis:5.0

That will create a service named rediscache, of type redis, specifically version 3.0.

Expose the Redis service to your application 

In your file, you now need to open a connection to the new Redis service. Under the relationships section, add the following:

    redis: "rediscache:redis"

The key (left side) is the name that will be exposed to the application in the PLATFORM_RELATIONSHIPS variable. The right hand side is the name of the service you specified above (rediscache) and the endpoint (redis). If you named the service something different above, change rediscache to that.

Add the Redis PHP extension 

Because the Redis extension for PHP has been known to have BC breaks at times, we do not bundle a specific verison by default. Instead, we provide a script to allow you to build your desired version in the build hook. See the PHP-Redis page for a simple-to-install script and instructions.

(Skip this part if using Predis.)

Add the Drupal module 

You will need to add the Redis module to your project.

If you are using Drush Make, you can add these lines to your project.make file:

projects[redis][version] = 3.15

To use the Predis library, also add it to your make file:

libraries[predis][download][type] = get
libraries[predis][download][url] =
libraries[predis][directory_name] = predis
libraries[predis][destination] = libraries


To make use of the Redis cache you will need to set some Drupal variables. You can either do this in your settings.php file or by setting Platform Variables directly via the management console. In general, using the settings.php file is easier.

Via settings.php 

To configure Drupal 7 to use our Redis server for caching, place the following at the end of settings.php, after the include directive for settings.local.php:


  $relationships = json_decode(base64_decode($_ENV['PLATFORM_RELATIONSHIPS']), TRUE);
  if (!empty($relationships['redis'])) {
    $conf['redis_client_host'] = $relationships['redis'][0]['host'];
    $conf['redis_client_port'] = $relationships['redis'][0]['port'];
    $conf['redis_client_interface'] = 'PhpRedis';
    $conf['cache_backends'][]       = 'sites/all/modules/contrib/redis/';
    $conf['cache_default_class']    = 'Redis_Cache';
    // The 'cache_form' bin must be assigned to non-volatile storage.
    $conf['cache_class_cache_form'] = 'DrupalDatabaseCache';
    // The 'cache_field' bin must be transactional.
    $conf['cache_class_cache_field'] = 'DrupalDatabaseCache';

If using Predis, change the PhpRedis reference to Predis (case-sensitive). If your redis module is not installed in sites/all/modules/contrib, modify the cache_backends line accordingly.

Via the management console 

Alternatively, add the following environment variables using the management console. Note, if you set a directory in the make file you will need to alter the variables to match.



Use the actual path to your Redis module in case it is in a different location. For example: sites/all/modules/redis. The location used above is the default when using Drush on









And finally, set the client interface to either PhpRedis or Predis.





Verifying Redis is running 

Run this command in a SSH session in your environment redis-cli -h redis.internal info. You should run it before you push all this new code to your repository.

This should give you a baseline of activity on your Redis installation. There should be very little memory allocated to the Redis cache.

After you push this code, you should run the command and notice that allocated memory will start jumping.