Skip to content

Commit bb7e175

Browse files
author
epriestley
committed
Update install guide to point at install scripts
Summary: Point users at the install scripts. Fix some common points of confusion and update some other documentation points. The links point to a directory which ultimately serves these scripts out of the git checkout on the machine: http://phabricator.com/rsrc/install/install_rhel-derivs.sh http://phabricator.com/rsrc/install/install_ubuntu.sh Test Plan: Read documentation. Reviewed By: aran Reviewers: codeblock, jungejason, tuomaspelkonen, aran Commenters: jungejason CC: aran, epriestley, jungejason Differential Revision: 439
1 parent 78fd0f6 commit bb7e175

File tree

1 file changed

+33
-15
lines changed

1 file changed

+33
-15
lines changed

src/docs/installation_guide.diviner

Lines changed: 33 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,12 @@ running.
88

99
Phabricator is a LAMP application suite, so you basically need LAMP:
1010

11-
- **Linux**: Some flavor of Linux is required. MacOS is an acceptable flavor
12-
of Linux. Windows is not an acceptable flavor of Linux. Phabricator will not
13-
install or work properly on Windows. (If you want it to, send patches.)
14-
Phabricator is actively developed on OSX and Amazon's Linux; if you run
15-
into issues on other flavors, send patches or complaints.
11+
- **Linux**: Some flavor of Linux is required. Mac OS X is an acceptable
12+
flavor of Linux. Windows is not an acceptable flavor of Linux. Phabricator
13+
will not install or work properly on Windows. (If you want it to, send
14+
patches.) Phabricator has active contributors running it on Mac OS X, Amazon
15+
Linux, Ubuntu, RHEL and CentOS; if you run into issues on other flavors,
16+
send patches or complaints.
1617
- **Apache**: You need Apache. You might be able to use something else, but
1718
you're on your own.
1819
- **MySQL**: You need MySQL.
@@ -23,17 +24,34 @@ You'll probably also need a **domain name** and you'll certainly need
2324

2425
= Installing Required Components =
2526

26-
This document assumes you have "yum". If you don't, substitute whatever package
27-
manager you do have, or go hunt down all this stuff and build it from source
28-
if you want.
27+
If you are installing on Ubuntu or an RedHat derivative, there are install
28+
scripts available which should handle most of the things discussed in this
29+
document for you:
2930

30-
Install things we need:
31+
- **RedHat Derivatives**: <http://phabricator.com/rsrc/install/install_rhel-derivs.sh>
32+
- **Ubuntu**: <http://phabricator.com/rsrc/install/install_ubuntu.sh>
3133

32-
sudo yum install git httpd php mysql-server php-mysql php-devel
34+
If those work for you, you can skip directly to the
35+
@{article:Configuration Guide}. These scripts are also available in the
36+
##scripts/install## directory in the project itself.
3337

34-
If you already have LAMP setup, you've already got everything you need.
38+
Otherwise, here's a general description of what you need to install:
3539

36-
Now that you have git installed, grab Phabricator and its dependencies:
40+
- git (usually called "git" in package management systems)
41+
- Apache (usually "httpd" or "apache2")
42+
- MySQL Server (usually "mysqld" or "mysql-server")
43+
- PHP (usually "php")
44+
- Required PHP extensions: mysql, curl, pcntl (these might be something like
45+
"php-mysql" or "php5-mysql")
46+
- Optional PHP extensions: gd, apc (special instructions for APC are available
47+
below if you have difficulty installing it)
48+
49+
If you already have LAMP setup, you've probably already got everything you need.
50+
It may also be helpful to refer to the install scripts above, even if they don't
51+
work for your system.
52+
53+
Now that you have all that stuff installed, grab Phabricator and its
54+
dependencies:
3755

3856
$ cd somewhere/ # pick some install directory
3957
somewhere/ $ git clone git://github.com/facebook/libphutil.git
@@ -49,13 +67,13 @@ installed. You likely need to install "pcre-devel" first:
4967

5068
sudo yum install pcre-devel
5169

52-
Then you can either install via PECL:
70+
Then you have two options. Either install via PECL (try this first):
5371

5472
sudo yum install php-pear
5573
sudo pecl install apc
5674

57-
...or grab the package from PECL directly and follow the build instructions
58-
there:
75+
**If that doesn't work**, grab the package from PECL directly and follow the
76+
build instructions there:
5977

6078
http://pecl.php.net/package/APC
6179

0 commit comments

Comments
 (0)