Building PSOL From Source

Maks Orlovich edited this page Sep 9, 2016 · 44 revisions

Most people will be fine using the binary distribution of PSOL to build ngx_pagespeed the standard way but if that isn't working for you or you want to make changes that require changing the PSOL core, then you need to build PSOL from source.

If you are running Centos5, or have come across this error

  LINK(target) out/Release/pagespeed_automatic_test
/usr/bin/ld: BFD 20061020 internal error, aborting at ../../bfd/merge.c line 863 in _bfd_merged_section_offset

/usr/bin/ld: Please report this bug.

collect2: ld returned 1 exit status

You will need to install a newer version of binutils.

$ wget
$ tar xvf binutils-2.25.tar.gz
$ cd binutils-2.25
$ ./configure
$ make
$ sudo make install

First build mod_pagespeed at the tag we currently work at:

$ mkdir -p ~/bin
$ cd ~/bin
$ git clone
$ export PATH=$PATH:~/bin/depot_tools
$ mkdir ~/mod_pagespeed
$ cd ~/mod_pagespeed
$ git clone src
$ gclient config --unmanaged --name=src
$ cd src/
$ git checkout ${BRANCH}
$ cd ..
$ gclient sync --force --jobs=1 # add --revision=xxxx for a specific git revision
$ make"$PWD/build/wrappers/" \"$PWD/build/wrappers/" \
       BUILDTYPE=Release \
       mod_pagespeed_test pagespeed_automatic_test

(See mod_pagespeed: build from source if you run into trouble, or ask for help on the mailing list.)

Then build the pagespeed optimization library:

against trunk-tracking

$ cd ~/mod_pagespeed/src/pagespeed/automatic
$ make BUILDTYPE=Release \
       -C ../../pagespeed/automatic \"$PWD/../../build/wrappers/" \"$PWD/../../build/wrappers/" \

or against master or a 1.9.32.x tag.

$ cd ~/mod_pagespeed/src/pagespeed/automatic
$ make BUILDTYPE=Release \"$PWD/../../../build/wrappers/" \"$PWD/../../../build/wrappers/" \

Check out ngx_pagespeed:

$ cd ~
$ git clone

Download and build nginx:

$ cd ~
$ # check for the latest version
$ wget
$ tar -xvzf nginx-1.8.0.tar.gz
$ cd nginx-1.8.0/
$ MOD_PAGESPEED_DIR="$HOME/mod_pagespeed/src" ./configure \
$ make install

This assumes you put everything in your home directory; if not, change paths appropriately. All paths need to be absolute.

If ./configure fails, check the error log in obj/autoconf.err for details.

For a debug build change BUILDTYPE=Release to BUILDTYPE=Debug and add the flag --with-debug to ./configure --add-module=....

If you're testing this and don't want to install this as root, which is a good idea, you can use --prefix, as in ./configure --add-module=... --prefix=$HOME/nginx and then nginx will install to a single directory inside your home directory.