Building and installing HHVM on Ubuntu 12.04

Josh Watzman edited this page Nov 28, 2015 · 80 revisions

Packages installation

Using sudo or as root user: (you may have to run sudo apt-get update first)

sudo apt-get install git-core gawk cmake g++ libmysqlclient-dev \
  libxml2-dev libmcrypt-dev libicu-dev openssl build-essential binutils-dev \
  libcap-dev libgd2-xpm-dev zlib1g-dev libtbb-dev libonig-dev libpcre3-dev \
  autoconf automake libtool libcurl4-openssl-dev \
  wget memcached libreadline-dev libncurses-dev libmemcached-dev libbz2-dev \
  libc-client2007e-dev php5-mcrypt php5-imagick libgoogle-perftools-dev \
  libcloog-ppl0 libelf-dev libdwarf-dev subversion python-software-properties \
  libmagickwand-dev libxslt1-dev libevent-dev gawk \
  libyaml-dev gperf

Upgrading gcc to 4.8

HHVM requires gcc >= 4.8.0, but Ubuntu 12.04 only ships with 4.6. To get a more recent version, follow these steps:

sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-4.8 g++-4.8

Then make gcc-4.8 the default compiler by updating the alternates db:

sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 60 \
                         --slave /usr/bin/g++ g++ /usr/bin/g++-4.8
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.6 40 \
                         --slave /usr/bin/g++ g++ /usr/bin/g++-4.6
sudo update-alternatives --set gcc /usr/bin/gcc-4.8

Installing Boost 1.55

Similarly, HHVM requires Boost 1.51, but Ubuntu 12.04 only ships with 1.48. To get a more recent version, follow these steps:

sudo add-apt-repository ppa:boost-latest/ppa
sudo apt-get update
sudo apt-get install libboost1.55-all-dev

Build ocaml

Hack support requires at least OCaml 4.01, so we need to build a newer version than 3.12 which ships with the OS.

tar xvf ocaml-4.02.1.tar.gz
cd ocaml-4.02.1
make world.opt
sudo make install

Getting HipHop source-code

mkdir dev
cd dev
git clone git:// --depth=1
cd hhvm
git submodule update --init --recursive
export CMAKE_PREFIX_PATH=`pwd`/..
cd ..

Building third-party libraries


Make sure that your system time is correct, otherwise ./configure will fail.

git clone git:// --depth=1
cd curl
./configure --prefix=$CMAKE_PREFIX_PATH
make install
cd ..

Google glog

svn checkout google-glog
cd google-glog
./configure --prefix=$CMAKE_PREFIX_PATH
make install
cd ..

Note: If you're not authenticated as the root user, use sudo make install instead of make install, or you will get problems on the cmake.

JEMalloc 3.x

tar xjvf jemalloc-3.6.0.tar.bz2
cd jemalloc-3.6.0
./configure --prefix=$CMAKE_PREFIX_PATH
make install
cd ..

Building HipHop

Please ensure that your machine has more than 1GB of RAM

cd hhvm
cmake -DENABLE_MCROUTER=false .

Running programs

The hhvm binary can be found in hphp/hhvm/hhvm.

The Hack language



If any errors occur, it may be required to remove the CMakeCache.txt file in the checkout.

If your failure was on the make command, try to correct the error and run make again, it should restart from the point it stops.


If CMake is complaining about libicu/ICU then you may need to build ICU manually before cmake will run:

tar -xzvf icu4c-52_1-src.tgz
cd icu/source
./configure --prefix=$CMAKE_PREFIX_PATH
sudo make install

Then delete the CMakeCache.txt file in the hhvm directory if it exists to get a clean CMake run.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.