How to enable Litespeed Cache on Joomla

Implementing LiteSpeed Cache (LSCache) for Joomla significantly optimizes site performance. By saving static snapshots of your dynamic web content, the extension bypasses resource-heavy PHP engine tasks and relational database lookups.

The integration relies on an advanced, tag-based purge architecture: when you update an article, module, or menu layout, LSCache identifies and purges only the affected pages, leaving the rest of your cached environment untouched.

Step 1: Establish Server-Level Redirection Cache Rules

Before activating the backend Joomla extension, you must instruct the LiteSpeed Web Server engine to watch for and accept caching headers from your domain.

Log into your hosting account dashboard, access your site’s root file directory via SSH, and open your primary local .htaccess configuration file. Inject the following structural block at the top of the file:

Apache

<IfModule LiteSpeed>
    CacheLookup on
</IfModule>

Mobile View Configurations

If your site serves an entirely separate mobile template instead of using a responsive CSS design layout, append these additional matching environment instructions beneath your lookup line:

Apache

<IfModule LiteSpeed>
    RewriteEngine On
    RewriteCond %{HTTP_USER_AGENT} Mobile|Android|Silk/|Kindle|BlackBerry|Opera\ Mini|Opera\ Mobi [NC]
    RewriteRule .* - [E=Cache-Control:vary=ismobile]
</IfModule>

Step 2: Download and Deploy the LSCache Extension Package

1. Navigate to the official LiteSpeed download center or their public GitHub repository, and save the compressed archive file (e.g., lscache-latest.zip) optimized for your Joomla branch.
2. Log into your Joomla administrator back-office dashboard.
3. Access the system installation workspace based on your core version:
   • Joomla 4.x / 5.x: Navigate to System (Left Menu Panel), open Install, and select Extensions.
   • Joomla 3.x: Navigate to Extensions (Top Horizontal Menu), open Manage, and select Install.
4. Select the Upload Package File tab workspace. Drag your downloaded .zip file directly into the designated upload field. The installation engine will automatically parse the archive, build the necessary database tables, and establish the module hooks.

Step 3: Verify and Enable the System Plugin

Joomla installs extensions in a default inactive state. You must manually activate the system component before editing configuration options:

1. Move to your Plugins directory dashboard. You can access this via System, open Manage, and select Plugins (or Extensions, then Plugins).
2. Use the local search field and type LiteSpeed to filter your plugin logs.
3. Locate the row labeled System – LiteSpeed Cache. If the status column displays a red indicator, click it to change the state to an active Green Check Mark.

Step 4: Configure Optimization Settings

Once activated, access the primary configuration interface panel. Depending on your version, navigate to Components, open LiteSpeed Cache, and click Options, or access System, open Global Configuration, and select LiteSpeed Cache from the component choices on the left.

Basic Configuration Tab

• Enable LiteSpeed Cache: Toggle this master variable to Yes.
• Public Cache TTL (minutes): Dictates how long static pages remain valid within the server memory matrix before checking for fresh database content. Because LSCache uses a smart, auto-purge architecture when content changes, you can confidently set a higher duration (e.g., 2000 minutes or more).

Exclude Rules Tab

To prevent data corruption, session mixing, or shopping cart calculation errors, ensure dynamic pages are completely isolated from your public cache layer:

• Exclude Components: Click into this multi-select selection array and flag all components that depend on continuous user interactions or real-time data inputs (such as user dashboards, payment forms, or e-commerce checkouts).

Step 5: Verify the Edge Cache Handshake

To verify that your web assets are being successfully saved and served from the server-level cache framework:

1. Launch an external, logged-out private browser window and open your website viewport.
2. Open your browser’s Developer Tools network console (typically Right-Click, open Inspect, and select the Network Tab).
3. Execute a manual page reload to view your asset loading files.
4. Click on your primary document file line (the topmost HTML row match) and evaluate the returned Response Headers data stream.

Plaintext

X-LiteSpeed-Cache: hit
X-LiteSpeed-Cache-Control: public, max-age=120000
X-LiteSpeed-Tag: J3_A11, J3_C18, J3_M22

• X-LiteSpeed-Cache: miss means the server-level memory has not captured a static snapshot of the page yet, but it has initiated a recording sequence for the next user hit.
• X-LiteSpeed-Cache: hit confirms that your server is serving the compiled asset layout instantly from cache, successfully bypassing the PHP parsing runtime.