Skip to main content

​
How do I enable LiteMage?

There are a few steps involved in enabling the LiteMage Caching for your Magento Store. These can be broken down into three steps (which are detailed below).
  1. Enable the LiteMage module: You will need to enable the LiteMage Module via your .htaccess file located in the root Magento installation directory. You can place the code at the top of the default .htaccess used by Magento or at the bottom; the choice is yours. <IfModule Litespeed> LiteMage on </IfModule> Please note: Without this being in your .htaccess, the LiteMage system will not function, so it is important to check the .htaccess on each update to Magento to make sure those lines still exist—if not, then add them back in.
  2. Install the Magento LiteMage extension: You will need to install the Magento LiteMage extension into your Magento installation.
    1. Enable SSH for your service (see this guide on how to do this).
    2. Increase your PHP memory_limit to 512M (see this guide on how to do this).
    3. SSH into your shared hosting service and run the following commands: Please note: Depending on the size of your store, this may take several minutes, and whilst recompiling, your store may be inaccessible. 
      cd public_html
php bin/magento deploy:mode:set developer
wget https://github.com/litespeedtech/magento2-LiteSpeed_LiteMage/archive/master.zip
unzip master.zip
mkdir -p app/code/Litespeed/Litemage
mv magento2-LiteSpeed_LiteMage-master/* app/code/Litespeed/Litemage/
php bin/magento module:enable Litespeed_Litemage
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento deploy:mode:set production
php bin/magento cache:clean
php bin/magento cache:flush
    4. You can now log out of SSH and disable it if you no longer have a need for it.
  3. Configure the Magento LiteMage extension:
    1. Log in to the Magento Admin Panel using your login credentials.
    2. Navigate to Stores → Configuration.
    3. In the left side menu, go to Advanced → System → Full Page Cache.
    4. Set the Caching Application to LiteMage Cache within LiteSpeed Server.
    5. Click the Save Config button at the top of the screen.
    6. Navigate to System → Cache Management and under Cache Storage Management, check all of the boxes.
    7. Click the Submit button to refresh the cache.

​
Before continuing

  • LiteMage Cache is only available on our new Shared and Reseller hosting. Our legacy Economy, Business, and WHM Multi servers do not support LiteMage Cache.
  • You should follow these steps exactly as described, since not following them may make your store not operate properly.
  • Make sure you disable all ‘Full Page Cache’ extensions—these will interfere with LiteMage. Examples include ‘Extendware Full Page Cache’.
  • If you are using Magento Compilation (System → Tools → Compilation), then you should disable it first before installing any extensions.
  • Take a backup before proceeding!
  • IonCube Loader is required for the Magento LiteMage Extension, so make sure you have enabled it. If you’re unsure, login to cPanel and navigate to Select PHP Version and confirm this is enabled.

​
General troubleshooting

There is a fairly extensive troubleshooting guide online at LiteSpeed’s dedicated LiteMage Troubleshooting Guide, plus extensive other online resources that can be found with a simple Google search. We have compiled a list of the most common troubleshooting tips and this will be updated from time to time. If you have any suggestions, please feel free to leave a comment on this article and we can have these added in.

​
How do I clear or flush the LiteMage Cache?

Once LiteMage Cache has been enabled, a ‘Flush LiteMage Cache’ button will show up under System → Cache Management. If you click the buttons ‘Flush Magento Cache’ or ‘Flush Cache Storage’, it will automatically flush the LiteMage Cache.

​
Can I enable LiteMage cache for just my IP address only for testing purposes?

Yes, you can! Head to Magento Admin → Stores → Configuration → LiteMage Cache → LiteMage Configuration → Developer Testing → Enable LiteMage Cache Only for Listed IP’s and then enter your IP address or the IP address you want to have the cache enabled for.
⌘I