How to integrate Redis into Craft 3

Redis is available on all Kualo Business Hosting plans and can significantly speed up Craft CMS by handling application caching. This guide walks you through the integration.

Requirements

• A Craft CMS 3 installation on your account
• A Kualo Business Hosting plan (Redis is not available on lower-tier plans)
• SSH access enabled on your account

If you need to upgrade your plan or have SSH access enabled, open a support ticket with our HelpDesk.

Step 1 - Install the Redis package

1. SSH into your hosting account.
2. Navigate to your Craft installation folder.
3. Run the following command to install the Yii2 Redis package:

composer require --prefer-dist yiisoft/yii2-redis

Step 2 - Configure Craft to use Redis

1. Open config/app.php in your Craft installation.
2. Add the following code below the opening return [ line:

'components' => [
    'cache' => [
        'class' => yii\redis\Cache::class,
        'defaultDuration' => 86400,
        'redis' => [
            'unixSocket' => '/home/USER/.kxcache/redis.sock',
            'database' => 0,
        ],
    ],
],

3. Replace USER with your cPanel username.
4. If you are running multiple Redis instances on the same account, assign each a unique database number (for example, 0, 1, 2).

If you run into any problems, open a support ticket with our HelpDesk.