This document contains basic install instructions to get Phabricator up andrunning.

Overview

Phabricator is a LAMP (Linux, Apache, MySQL, PHP) application. To installPhabricator, you will need:

• a normal computer to install it on (shared hosts and unusual environments are not supported) running some flavor of Linux or a similar OS;
• a domain name (likephabricator.mycompany.com);
• basic sysadmin skills;
• Apache, nginx, or another webserver;
• PHP, MySQL, and Git.

The remainder of this document details these requirements.

Installation Requirements

You will needa computer. Options include:

• A Normal Computer: This is strongly recommended. Many installs use a VM in EC2. Phabricator installs properly and works well on a normal computer.
• A Shared Host: This may work, but is not recommended. Many shared hosting environments have restrictions which prevent some of Phabricator's features from working. Consider using a normal computer instead. We do not support shared hosts.
• A SAN Appliance, Network Router, Gaming Console, Raspberry Pi, etc.: Although you may be able to install Phabricator on specialized hardware, it is unlikely to work well and will be difficult for us to support. Strongly consider using a normal computer instead. We do not support specialized hardware.
• A Toaster, Car, Firearm, Thermostat, etc.: Yes, many modern devices now have embedded computing capability. We live in interesting times. However, you should not install Phabricator on these devices. Instead, install it on a normal computer. We do not support installing on noncomputing devices.

To install the Phabricator server software, you will need anoperatingsystem on your normal computer which isnot Windows. Note that thecommand line interfacedoes work on Windows, and you canusePhabricator from any operating system with a web browser. However, the serversoftware does not run on Windows. It does run on most other operating systems,so choose one of these instead:

• Linux: Most installs use Linux.
• Mac OS X: Mac OS X is an acceptable flavor of Linux.
• FreeBSD: While FreeBSD is certainly not a flavor of Linux, it is a fine operating system possessed of many desirable qualities, and Phabricator will install and run properly on FreeBSD.
• Solaris, etc.: Other systems which look like Linux and quack like Linux will generally work fine, although we may suffer a reduced ability to support and resolve issues on unusual operating systems.

Beyond an operating system, you will needa webserver.

• Apache: Many installs use Apache +mod_php.
• nginx: Many installs use nginx +php-fpm.
• lighttpd:lighttpd is less popular than Apache or nginx, but it works fine.
• Other: Other webservers which can run PHP are also likely to work fine, although these installation instructions will not cover how to set them up.
• PHP Builtin Server: Phabricator will not work with the builtin webserver because Phabricator depends on making requests to itself on some workflows, and the builtin webserver is single-threaded.

You will also need:

• MySQL: You need MySQL. We strongly recommend MySQL 5.5 or newer.
• PHP: You need PHP 5.5 or newer.

You'll probably also need adomain name. In particular, you should read thisnote:

Level Requirements

To install and administrate Phabricator, you'll need to be comfortable withcommon system administration skills. For example, you should be familiar withusing the command line, installing software on your operating system of choice,working with the filesystem, managing processes, dealing with permissions,editing configuration files, and setting environment variables.

If you aren't comfortable with these skills, you can still try to perform aninstall. The install documentation will attempt to guide you through what youneed to know. However, if you aren't very familiar or comfortable with usingthis set of skills to troubleshoot and resolve problems, you may encounterissues which you have substantial difficulty working through.

We assume users installing and administrating Phabricator are comfortable withcommon system administration skills and concepts. If you aren't, proceed atyour own risk and expect that your skills may be tested.

Installing Required Components

Here's a general description of what you need to install:

• git (usually called "git" in package management systems)
• Apache (usually "httpd" or "apache2") (or nginx)
• MySQL Server (usually "mysqld" or "mysql-server")
• PHP (usually "php")
• Required PHP extensions: mbstring, iconv, mysql (or mysqli), curl, pcntl (these might be something like "php-mysql" or "php5-mysqlnd")
• Optional PHP extensions: gd

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'twork for your system.

Now that you have all that stuff installed, grab Phabricator and itsdependencies:

$ cd somewhere/# pick some install directorysomewhere/$ git clone https://github.com/phacility/arcanist.gitsomewhere/$ git clone https://github.com/phacility/phabricator.git

Next Steps

Continue by:

• configuring Phabricator with theConfiguration Guide; or
• learning how to keep Phabricator up to date withUpgrading Phabricator.