This document contains basic install instructions to get Phabricator up and running.
You will need a computer. Options include:
To install the Phabricator server software, you will need an operating system on your normal computer which is not Windows. Note that the command line interface does work on Windows, and you can use Phabricator from any operating system with a web browser. However, the server software does not run on Windows. It does run on most other operating systems, so choose one of these instead:
Beyond an operating system, you will need a webserver.
You will also need:
You'll probably also need a domain name. In particular, you should read this note:
If you are installing on Ubuntu or an RedHat derivative, there are install scripts available which should handle most of the things discussed in this document for you:
If those work for you, you can skip directly to the Configuration Guide. These scripts are also available in the scripts/install directory in the project itself.
Otherwise, here's a general description of what you need to install:
If you already have LAMP setup, you've probably already got everything you need. It may also be helpful to refer to the install scripts above, even if they don't work for your system.
Now that you have all that stuff installed, grab Phabricator and its dependencies:
$ cd somewhere/ # pick some install directory somewhere/ $ git clone git://github.com/facebook/libphutil.git somewhere/ $ git clone git://github.com/facebook/arcanist.git somewhere/ $ git clone git://github.com/facebook/phabricator.git
Like everything else written in PHP, Phabricator will run much faster with APC installed. You likely need to install "pcre-devel" first:
sudo yum install pcre-devel
Then you have two options. Either install via PECL (try this first):
sudo yum install php-pear sudo pecl install apc
If that doesn't work, grab the package from PECL directly and follow the build instructions there:
Installing APC is optional but strongly recommended, especially on production hosts.
Once APC is installed, test that it is available by running:
php -i | grep apc
If it doesn't show up, add:
..to "/etc/php.d/apc.ini" or the "php.ini" file indicated by "php -i".
XHProf is a PHP profiling tool. You don't need to install it unless you are developing Phabricator and making performance changes.
You can install xhprof with:
$ pecl install xhprof
If you have a PEAR version prior to 1.9.3, you may run into a phpize failure. If so, you can download the source and build it with:
$ cd extension/ $ phpize $ ./configure $ make $ sudo make install
You may also need to add "extension=xhprof.so" to your php.ini.
See https://bugs.php.net/bug.php?id=59747 for more information.
Since Phabricator is under active development, you should update frequently. To update Phabricator:
For more details, see Configuration Guide. You can use a script similar to this one to automate the process: