This is an old revision of the document!

LSCache + MediaWiki Configuration

LSCache, similar to Varnish cache, is a simpler and more efficient page-caching solution built in to LiteSpeed Web Server. When used in conjunction with MediaWiki, you can expect significant performance gains and a quick and easy setup. Cache management is also made significantly easier and more flexible with the ability to use rewrite rules to customize cache behavior.

Below are some recommended configurations to enable LSCache and get it working with your MediaWiki site(s).

Server/Virtual-Host-level cache storage needs to be configured properly for your environment. Select your server setup from the Web Server Configuration section of our LiteSpeed Cache Installation Guide and follow the instructions to set the server/virtual-host-level cache root and cache policy.

At the .htaccess file in the document root of your website after:

# Various rewrite rules.
<IfModule mod_rewrite.c>

Add the following rewrite rules:

########## Begin - Litespeed cache
<IfModule LiteSpeed>
   RewriteEngine On
   CacheDisable public /
   RewriteCond %{HTTP_COOKIE} !mediawiki_wiki__session
   RewriteCond %{HTTP_COOKIE} !mediawiki_wiki_UserID
   RewriteCond %{QUERY_STRING} !nocache
   RewriteRule .* - [E=cache-control:max-age=120]
########## End - Litespeed cache


  • The CacheDisable public / directive is used to help protect against globally-enabled caching and is optional. If this directive is not used, the server's global cache settings should be checked to ensure that cache is not enabled globally. Do NOT use CacheEnable public / here as it will enable caching for all URLs belonging to this virtual host, including admin pages.
  • We recommend using a different domain for your backend so that you can add/edit/preview a website's content through the admin domain without worrying about these changes being cached and seen by visitors.
  • To get the non-cached version of a page, add the ?nocache query string to a URL.

For example:

Look for X-LiteSpeed-Cache: hit in the reply headers. See more detailed directions here.

Please refer to this wiki to learn how to clean up outdated cache files.

  • Admin
  • Last modified: 2017/09/13 14:19
  • by Usman Nasir