1
0
Fork 0
mirror of https://we.phorge.it/source/phorge.git synced 2024-12-01 11:12:42 +01:00
phorge-phorge/src/docs/installation_guide.diviner
epriestley 09b498cbc2 Document the need to do "git submodule update --init" after cloning
Summary:
After rP2a39fd09ebe7f4fc8cd2ab0b39bbb0e466f357c3, you need to run this command
after cloning Phabricator.

Git, world's hardest revision control system

Test Plan:
read text

Reviewed By: rm
Reviewers: tomo, tuomaspelkonen, jungejason, aran, rm
CC: aran, rm, epriestley
Differential Revision: 252
2011-05-08 21:23:44 -07:00

92 lines
2.8 KiB
Text

@title Installation Guide
@group install
This document contains basic install instructions to get Phabricator up and
running.
= Installation Requirements =
Phabricator is a LAMP application suite, so you basically need LAMP:
- **Linux**: Some flavor of Linux is required. MacOS is an acceptable flavor
of Linux. Windows is not an acceptable flavor of Linux. Phabricator will not
install or work properly on Windows. (If you want it to, send patches.)
Phabricator is actively developed on OSX and Amazon's Linux; if you run
into issues on other flavors, send patches or complaints.
- **Apache**: You need Apache. You might be able to use something else, but
you're on your own.
- **MySQL**: You need MySQL.
- **PHP**: You need PHP 5.2 or newer.
You'll probably also need a **domain name** and you'll certainly need
**a computer** with a connection to **the internet**.
= Installing Required Components =
This document assumes you have "yum". If you don't, substitute whatever package
manager you do have, or go hunt down all this stuff and build it from source
if you want.
Install things we need:
sudo yum install git httpd php mysql-server php-mysql php-devel
If you already have LAMP setup, you've already got everything you need.
Now that you have git 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
somewhere/ $ cd phabricator
somewhere/phabricator/ $ git submodule update --init
= Installing Optional Components =
== APC ==
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 can either install via PECL:
sudo yum install php-pear
sudo pecl install apc
...or grab the package from PECL directly and follow the build instructions
there:
http://pecl.php.net/package/APC
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:
extension=apc.so
..to "/etc/php.d/apc.ini" or the "php.ini" file indicated by "php -i".
== Flex 2.5.35 / Bison ==
If you want to build XHPAST (an XHP parser, which is required for developing
libphutil or Arcanist), you also need flex 2.5.35, which is a NEWER version
than flex 2.5.4. At the time of writing, most packaging systems don't have flex
2.5.35 available. You can get it from here and compile it manually:
http://flex.sourceforge.net/
Then install bison normally:
sudo yum install bison
= Next Steps =
If everything is installed, move on to @{article:Configuration Guide}.