Installing and configuring LiteMage

LiteMage is a full‑page caching solution designed specifically for Magento when running on LiteSpeed servers. It delivers faster page loads, reduces server load, and improves customer experience. On ruachost.com, LiteMage can be installed and configured for both Magento 1 and Magento 2.

Why Use LiteMage?

Provides full‑page caching optimized for Magento.
Reduces server response times and improves scalability.
Works seamlessly with LiteSpeed Web Server.
Supports ESI (Edge Side Includes) for dynamic content caching.

Installing LiteMage on Magento 2

Access your account via SSH.
Navigate to your Magento installation directory:
Terminal window
```
cd ~/public_html/magento
```
Set Magento to developer mode:
Terminal window
```
php bin/magento deploy:mode:set developer
```

Download the LiteMage plugin files:

wget https://github.com/litespeedtech/magento2-LiteSpeed_LiteMage/archive/master.zip

Extract the files:
Terminal window
```
unzip master.zip
```
Create the directory for LiteMage:
Terminal window
```
mkdir -p app/code/Litespeed/Litemage
```

Move the plugin files:

mv magento2-LiteSpeed_LiteMage-master/* app/code/Litespeed/Litemage/

Ensure correct file ownership:

chown -R username:username app/code/Litespeed/Litemage/

Enable the LiteMage module:

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

Edit .htaccess in the Magento root directory and add:
```
<IfModule Litespeed>
  LiteMage on
</IfModule>
```

Activating LiteMage on Magento 2

Log in to Magento Admin.
Go to Stores → Configuration → Advanced → System → Full Page Cache.
Select LiteMage Cache within LiteSpeed Server.
Save configuration.
Go to System → Cache Management.
Refresh Configuration and Page Cache.

Installing LiteMage on Magento 1

Download the LiteMage package from LiteSpeedTech.
Upload and install via Magento Connect Manager.

Edit .htaccess in the Magento root directory:

<IfModule Litespeed>
  LiteMage on
</IfModule>

Log in to Magento Admin.
Go to System → Configuration → LITEMAGE CACHE → LiteMage Configuration.
Enable LiteMage Cache.
Refresh cache under System → Cache Management.

Verifying LiteMage

Open your site in a browser.
Use Inspect → Network tab.
Refresh the page.
Look for response headers:
- X-LiteSpeed-Cache: hit,litemage → LiteMage is working.
- X-LiteSpeed-Cache: miss,litemage → Refresh again to confirm.

Important Notes

LiteMage requires a LiteSpeed server license (available on a Managed VPS).
Not available on shared hosting accounts.
Always back up your site before installing new modules.