- 1 mod_pagespeed overview
- 2 Enabling mod_pagespeed Console and Admin UI
- 3 Mod_pagespeed Caches
- 4 How to install mod_pagespeed Apache module on Ubuntu 14.10
- 5 Ubuntu 14.10 mod_pagespeed configuration
- 6 mod_pagespeed default CoreFilter list
- 7 How to configure mod_pagespeed to use Memcached
- 8 How to bypass mod_pagespeed filters
- 9 How to include extra filters for mod_pagespeed
- 10 mod_pagespeed .htaccess directives
- 11 Install PageSpeed Module (mod_pagespeed) on cPanel Server
- 12 How to use Memcached with ModPageSpeed on a cPanel Server
- 13 Additional Links
You can use mod_pagespeed to automatically optimize websites that use Nginx or Apache. Installing the module is pretty easy, regardless of what webserver you use. Mod_pagespeed can significantly improve the page load time of most websites and the default filters and optimizations used are totally safe for like 99.99% of websites out there.
mod_pagespeed will parse html before the user's browser recieves anything, pagespeed with apply compression, rewrite images, and perform other optimizations that reduce the amount of requests it takes to load a page and to reduce the page size. Not only does mod_pagespeed handle all the best practices for your website, it also utilizes a file system cache that it can pull from so Apache isn't always optimizing the same files over and over again.
The filesystem cache is enabled by default and must remain enabled for mod_pagespeed to work correctly. In addition to the file system cache you can also configure pagespeed to use a Shared Memory Cache for metadata which can be used by all Apache processes (and thread if you use Event). If two caches aren't good enough for you then you can also enable the PER Apache Process LRU cache, which gives each Apache process it's own cache to store small files in.
On top of all those caches, you can also enable the use of Memcached for even more caching. Confused? I was too at first, with so many caches and possible configuration options, it seems overwhelming at first, but I will cover all the caches in their own section below to hopefully explain how they all work together to make your site fast.
Enabling mod_pagespeed Console and Admin UI
To enable the mod_pagespeed Console, Admin UI and statistics you should make sure that you configure pagespeed.conf to look similar to what is shown below. You should enable logging and statistics if you want to have more information on what mod_pagespeed is doing. All of this information can be viewable from http://domain.com/pagespeed_admin assuming you allow the correct IPs. I strongly suggest you use the "allow,deny" statement, if you do not do that then anyone could view your pagespeed stats.
ModPagespeedEnableFilters add_instrumentation ModPagespeedMessageBufferSize 100000 ModPagespeedStatistics on ModPagespeedStatisticsLogging on ModPagespeedLogDir /var/log/pagespeed <Location /mod_pagespeed_beacon> SetHandler mod_pagespeed_beacon </Location> <Location /mod_pagespeed_statistics> Order allow,deny Allow from localhost Allow from $IP_1 Allow from $IP_2 SetHandler mod_pagespeed_statistics </Location> <Location /pagespeed_admin> Order allow,deny Allow from localhost Allow from 127.0.0.1 Allow from $IP_1 Allow from $IP_2 SetHandler pagespeed_admin </Location>
You can and should enable the FileCache for mod_pagespeed. This should be enabled by default, but if you notice that pagespeed isn't using the file cache or that Apache is complaining about something related to the FileCachePath you should view the main conf file and make sure the path is correctly set. You can use the syntax below to customize where the cache directory is / should be located. The path must be writable by the Apache user.
For example, on a cPanel server you might find that the cache is located under /var/
If you have many vhosts on the same server and notice that Apache complains about "ModPagespeedFileCachePath must not be empty". You can try adding the ModPagespeedInheritVHostConfig option in the main pagespeed.conf file. This allows all vhosts to inherit some globabl settings without having to specify the same settings for each vhost.
ModPagespeedInheritVHostConfig on ModPagespeedFileCachePath "/var/mod_pagespeed/cache/"
How to install mod_pagespeed Apache module on Ubuntu 14.10
wget https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-stable_current_amd64.deb dpkg -i mod-pagespeed-*.deb apt-get -f install
After the module is installed, Apache should already have been restarted and the module loaded, to make sure this is the case you can run
Ubuntu 14.10 mod_pagespeed configuration
To modify the default settings for mod pagespeed you can edit the main configuration file, which is called pagespeed.conf. If you are using Ubuntu, this can be found under the mods-enabled directory for apache. If you make any changes to pagespeed.conf you must restart apache or else the new settings will not take effect.
mod_pagespeed default CoreFilter list
By default, pagespeed will enable and use this list of filters, also know as the "core filters". Google considers all of these filters to be "safe" meaning that they shouldn't cause issues with most websites and CMS. I've found that the core filters work perfectly fine with WordPress and MediaWiki. If you wish to enable more filters you certainly can, but the list below contains the already enabled filters.
How to configure mod_pagespeed to use Memcached
To configure mod_pagespeed to use Memcached simply add the line below, and optionally the lines below it to enable moar caches that can be shared by all the apache processes. Obviously this assumes you have Memcached installed on the server and that it is listening on an open port that is accessible via localhost. If you are using cpanel you will want to edit the pagespeed.conf file located at /usr/local/apache/conf/pagespeed.conf, if you are using Ubuntu the file will be located at /etc/apache2/mods-enabled/pagespeed.conf
##Memcached## ModPagespeedMemcachedServers localhost:11211 ##File Cache, Shared Memory Cache, and LRU Cache## ModPagespeedFileCachePath "/var/mod_pagespeed/cache/" ModPagespeedCreateSharedMemoryMetadataCache "/var/mod_pagespeed/cache/" 51200 ModPagespeedFileCacheSizeKb 102400 ModPagespeedLRUCacheKbPerProcess 8192 ModPagespeedLRUCacheByteLimit 65536
You can view memcached stats by echoing stats and piping that into netcat.
echo stats | nc 127.0.0.1 11211
To view pagespeed specific memcached statistics you can simply curl the url from localhost if you have access to the server. This will display all of the pagespeed and memcached specific information
How to bypass mod_pagespeed filters
By default, the module uses "CoreFilters", which is a safe set of rules that most sites benefit from, if you want to disable everything and only enable certain items, you can do this globally here, however it's recommended to just enable / disable things per vhost using .htaccess or vhost directive. You would just uncomment the line below
# ModPagespeedRewriteLevel PassThrough
How to include extra filters for mod_pagespeed
If you want to globally enable more filters than the core rules offer you can uncomment these lines and just add the filters you want to enable.
mod_pagespeed .htaccess directives
You can specify additional filters in .htaccess, or in the main apache2.conf, or on the vhost level using a directive like this:
Install PageSpeed Module (mod_pagespeed) on cPanel Server
The easiest way to install mod_pagespeed on a cPanel server is to use git to clone the cpanel / pagespeed project from github. I've tested this out on CentOS 6.5 and CentOS 6.6 with WHM 11.48, and have never noticed any issues with the plugin, or with this installation method.
/usr/local/cpanel/3rdparty/bin/git clone https://github.com/pagespeed/cpanel.git /tmp/pagespeed/
After you've cloned the project using git, cd into /tmp/pagespeed/Easy and create a tarball that EasyApache can use to install the module when you run future EasyApache.
cd /tmp/pagespeed/Easy tar -zcvf Speed.pm.tar.gz pagespeed mkdir -p /var/cpanel/easy/apache/custom_opt_mods/Cpanel/Easy mv Speed.pm Speed.pm.tar.gz -t /var/cpanel/easy/apache/custom_opt_mods/Cpanel/Easy/ cd && rm -rf /tmp/pagespeed
At this point you should be able to run EasyApache, and when you go to customize profile, there should be a "mod_pagespeed" entry under the Apache module section. Make sure this is selected / checked and then tell EasyApache to save and build with the new profile. This can take up to 20 minutes to complete, but all your websites should remain online while this process occurs.
Now you can check to make sure the EA finished successfully and the module is enabled:
httpd -M ##You should see pagespeed_module (shared)
How to use Memcached with ModPageSpeed on a cPanel Server
If you are using cPanel and have mod_pagespeed installed you can modify the configuration file so that pagespeed uses memcached. This is not the base by default and if you want to speed up the site and use memory instead of just using disk you can edit the file listed below and enter in the IP and port of Memcached. In this case I have Memcached running on the same host. You will need to start apache after you are done editing the file.
vim /usr/local/apache/conf/pagespeed.conf ##Add These Lines ModPagespeedMemcachedServers 127.0.0.1:11211 ModPagespeedMemcachedThreads 1 ModPagespeedCreateSharedMemoryMetadataCache "/var/mod_pagespeed/cache" 51200
- PageSpeed can be added to any server runtime and applied dynamically to any application. This is available as a module for Apache and Nginx. This helps to optimize resources based on a lot of "web optimization filters".