Installation: Introduction

HHVM is officially supported on most major linux platforms. There is experimental, hope-to-be official support on Mac OS X 10.10. And work is being done to support HHVM on Windows.

Prebuilt Packages

The easiest way to get going with HHVM is to use one of our supported prebuilt packages. Currently prebuilt packages are available for:

LTS Releases

HHVM releases a point (stable) release on the order of every 8 weeks. Every third major point release of HHVM (e.g, 3.6, 3.9) is considered a long-term support (LTS) release. These releases are supported for around one year (~48 weeks), and are backported with critical bug fixes and security patches. At any given time, there will be two supported LTS releases.

LTS Version Release Date End of Support
3.12 29 January 2016 14 February 2017
3.15 7 September 2016 31 July 2017
3.18 14 February 2017 15 January 2018
3.21 31 July 2017 2 July 2018

In addition to the normal stable packages, there are supported LTS releases for the above distributions.

See our blog post regarding LTS releases.

Compiling HHVM

For normal usage, using a prebuilt package is the best course of action for ease of installation and stability. However, if you want to live on the bleeding edge and get the latest and greatest code as it is checked into GitHub, you can compile HHVM straight from source. Check the compilation instructions for both the supported Linux and Mac OS X distros.

If we support a prebuilt package for a distribution, we support compiling it from source as well.

Hack Typechecker

Whether you are using a prebuilt package or compiling from source, the Hack Typechecker is also part of the installation of HHVM, provided that you have OCaml 4.03 or greater installed on your distribution. In general, you should be able to apt-get or yum install OCaml for your distribution.

Unsupported Distributions

There are wikis of unsupported HHVM platforms for packages and compilation as well.