mod_pagespeed module for CPanel WHM
Latest commit bb268e1 Jun 21, 2016 @crowell crowell committed on GitHub Merge pull request #46 from pagespeed/add_upgrade_instrs
add instructions for upgrading mod_pagespeed/EA3|4
Failed to load latest commit information.
EA4 update spec Dec 17, 2015
Easy Merge pull request #37 from Prajithp/master Dec 17, 2015
LICENSE Update LICENSE Dec 15, 2015 add instructions for upgrading mod_pagespeed/EA3|4 Apr 13, 2016

mod_pagespeed module for CPanel WHM

A custom module for CPanel WHM using CPanel Easy Framework - allows easy installation of mod_pagespeed via /scripts/easyapache on command line or through easyapache from WHM web console.

Installation instructions

If you are using EasyApache4, please follow the below steps to install mod_pagespeed.

$> yum install rpm-build cpio ea-apache24-mod_version
$> wget
$> rpmbuild --rebuild ea-apache24-mod_pagespeed-1.9-32.11.src.rpm
$> rpm -ivh /root/rpmbuild/RPMS/x86_64/ea-apache24-mod_pagespeed-1.9-32.11.x86_64.rpm
$> /etc/init.d/httpd restart
  1. Clone the installation scripts onto your CPanel server:
$> /usr/local/cpanel/3rdparty/bin/git clone /tmp/pagespeed/
  1. Create
$> cd /tmp/pagespeed/Easy
$> tar -zcvf pagespeed
$> mkdir -p /var/cpanel/easy/apache/custom_opt_mods/Cpanel/Easy
$> mv -t /var/cpanel/easy/apache/custom_opt_mods/Cpanel/Easy/
$> cd && rm -rf /tmp/pagespeed
  1. Login into your cPanel WHM > EasyApache and look for "mod_pagespeed" option. Alternatively, you can run the easyapache installer from command line (/scripts/easyapache). Rebuild the Apache server, reboot it, and you're good to go!

Updating instructions

If you are using EasyApache3, run easyapache to upgrade mod_pagespeed to the latest version.

If you are running EasyApache4, follow these steps to upgrade.

  • create file /etc/rpm/macros.apache2 with the following contents

    %_httpd_mmn 20120211x8664
    %_httpd_apxs /usr/bin/apxs
    %_httpd_dir /etc/apache2
    %_httpd_bindir %{_httpd_dir}/bin
    %_httpd_modconfdir %{_httpd_dir}/conf.modules.d
    %_httpd_confdir %{_httpd_dir}/conf.d
    %_httpd_contentdir /usr/share/apache2
    %_httpd_moddir /usr/lib64/apache2/modules
  • then run the following commands

    rm -rf /root/rpmbuild/RPMS/x86_64/
    rpmbuild --rebuild ea-apache24-mod_pagespeed-latest-stable.src.rpm
    rpm -Uvh /root/rpmbuild/RPMS/x86_64/ea-apache24-mod_pagespeed*.rpm
    /etc/init.d/httpd restart

Configuring mod_pagespeed

The installation script will copy a default pagespeed.conf file into /usr/local/apache/conf/ on your server. Please consult the following pages to customize your configuration:

For example of the different filters in action and detailed documentation for each, please see