How to integrate LiteSpeed Cache into Craft 3

This guide originally walked you through installing and configuring the LiteSpeed Cache plugin for Craft CMS 3 on your Kualo hosting account. Because the plugin is no longer maintained, the steps below are preserved for reference only. For new installations, please use Blitz instead.

Before you begin, make sure you have enabled LiteSpeed Cache in cPanel. See How to enable LiteSpeed Cache in cPanel if you have not done this yet.

Installing LiteSpeed Cache through the dashboard

1. Log into your Craft CMS admin panel.

2. Click the Plugin Store menu.

   

3. Search for LiteSpeed Cache in the store.

   

4. Click the LiteSpeed Cache plugin result, then click Install.

   

Installing LiteSpeed Cache via the command line

SSH access must be enabled on your account before you can use the commands below. Open a ticket with our HelpDesk if you need SSH access enabled.

1. Navigate to your Craft project folder.
2. Run the following Composer command:

composer require thoughtfulweb/lite-speed-cache

Setting up the LiteSpeed Cache plugin

Once the plugin is installed, complete the following steps to finish the configuration.

1. Log into the Craft CMS dashboard.

2. Go to Settings > Plugins.

3. Click the gear icon next to LiteSpeed Cache and choose Install.

4. Once installed, click the Settings link.

   

5. Enable Clear caches per URL - unless you are using Cloudflare. Because Cloudflare acts as a reverse proxy, per-URL purging is not compatible with it.

6. In the .lscache Location box, enter the path below, replacing USER with your cPanel username:

   /home/USER/.lscache/
   

7. Click Save in the upper right of the page.

   

8. Add the following lines to the top of your .htaccess file:

########## Begin - LiteSpeed Cache
<IfModule LiteSpeed>
    RewriteEngine On
    RewriteCond %{REQUEST_METHOD} ^HEAD|GET$
    RewriteCond %{ORG_REQ_URI} !/admin
    RewriteCond %{ORG_REQ_URI} !/index.php/admin
    RewriteRule .* - [E=Cache-Control:max-age=86400]
</IfModule>
########## End - LiteSpeed Cache

LiteSpeed Cache should now be active. You can confirm it is working by following the steps in the Verify if LiteSpeed Cache is working article.

If you need help with any of the above, please contact our support team via the HelpDesk.

Purging LiteSpeed Cache from the dashboard

You can manually clear the LiteSpeed Cache at any time from the dashboard.

1. Click the LiteSpeed Cache menu in the dashboard.

2. Click the Clear LiteSpeed Cache button.