README.md

   1 # HHVM
   2
   3 [HHVM page](https://hhvm.com) |
   4 [HHVM documentation](https://docs.hhvm.com/hhvm/) |
   5 [Hacklang page](http://hacklang.org) |
   6 [General group](https://www.facebook.com/groups/hhvm.general/) |
   7 [Dev group](https://www.facebook.com/groups/hhvm.dev/) |
   8 [Twitter](https://twitter.com/HipHopVM)
   9
  10 HHVM is an open-source virtual machine designed for executing programs written in [Hack](http://hacklang.org). HHVM uses a just-in-time (JIT) compilation approach to achieve superior performance while maintaining the development flexibility that PHP provides.
  11
  12 HHVM is intended for [Hack](http://hacklang.org) projects, and also supports a large subset of PHP 7 that is required by common tools and libraries. We no longer recommend using HHVM for purely PHP projects.
  13
  14 HHVM should be used together with a webserver like the built in, easy to deploy [Proxygen](https://docs.hhvm.com/hhvm/basic-usage/proxygen), or a [FastCGI](https://docs.hhvm.com/hhvm/advanced-usage/fastCGI)-based webserver on top of nginx or Apache.
  15
  16 ## Installing
  17
  18 If you're new, try our [getting started guide](https://docs.hhvm.com/hhvm/getting-started/getting-started).
  19
  20 You can install a [prebuilt package](https://docs.hhvm.com/hhvm/installation/introduction#prebuilt-packages) or [compile from source](https://docs.hhvm.com/hhvm/installation/building-from-source).
  21
  22 ## Running
  23
  24 You can run standalone programs just by passing them to hhvm: `hhvm example.hack`.
  25
  26 If you want to host a website:
  27 * Install your favorite webserver. [Proxygen](https://docs.hhvm.com/hhvm/basic-usage/proxygen) is built in to HHVM, fast and easy to deploy.
  28 * Install our [package](https://docs.hhvm.com/hhvm/installation/introduction#prebuilt-packages)
  29 * Start your webserver
  30 * Run `sudo /etc/init.d/hhvm start`
  31 * Visit your site at `http://.../main.hack`
  32
  33 Our [getting started guide](https://docs.hhvm.com/hhvm/getting-started/getting-started) provides a slightly more detailed introduction as well as links to more information.
  34
  35 ## Contributing
  36
  37 We'd love to have your help in making HHVM better. If you're interested, please read our [guide to contributing](CONTRIBUTING.md).
  38
  39 ## License
  40
  41 HHVM is licensed under the PHP and Zend licenses except as otherwise noted.
  42
  43 The [Hack typechecker](hphp/hack) is licensed under the MIT [License](hphp/hack/LICENSE) except as otherwise noted.
  44
  45 ## Reporting Crashes
  46
  47 See [Reporting Crashes](https://github.com/facebook/hhvm/wiki/Reporting-Crashes) for helpful tips on how to report crashes in an actionable manner.
  48
  49 ## Security
  50
  51 For information on reporting security vulnerabilities in HHVM, see [SECURITY.md](SECURITY.md).
  52
  53 ## FAQ
  54
  55 Our [user FAQ](https://docs.hhvm.com/hhvm/FAQ/faq) has answers to many common questions about HHVM, from [general questions](https://docs.hhvm.com/hhvm/FAQ/faq#general) to questions geared towards those that want to [use](https://docs.hhvm.com/hhvm/FAQ/faq#users).
  56
  57 There is also a FAQ for [contributors](https://github.com/facebook/hhvm/wiki/FAQ#contributors) to HHVM.