Guide to Installing on MacOS

Important: Please reference Installing PHPCI for additional information!

OS X Server

Install OS X Server from the App Store.


Install XCode from the App Store, then:

  1. Open XCode.
  2. Open Preferences > Locations.
  3. Select the latest version of the Command Line Tools.
  4. Close Preferences and Quit XCode.
  5. Open a Terminal and type:
xcode-select --install

and click the Install button in the resulting alert window.


  1. Open a Terminal, and type:
bash <(curl -Ls
  1. Enter your account password and follow the rest of the instructions.
  2. This will have installed MySQL, a preference pane, and MySQL Pro for you, if you chose to do so.
  3. Get your MySQL root password, which was saved in a text file on your desktop:
cat ~/Desktop/MYSQL_PASSWORD
  1. Use that password to log into mysql:
cd ~
mysql -u root -p
  1. Create the new PHPCI database:
  1. Create the new PHPCI user, of course supplementing ‘password’ with your own password:
use mysql;
GRANT ALL PRIVILEGES ON *.* to 'phpci'@'localhost' IDENTIFIED by 'password' WITH GRANT OPTION;
  1. Exit MySQL if all went well using the exit command.
  2. Test that the new PHPCI user has access:
mysql -u phpci -p

If all went well, you should now be at the mysql prompt. Go ahead and exit back out.


  1. Install PEAR (and PECL, which comes bundled with PEAR):
mkdir ~/pear
cd ~/pear
curl -O
sudo php -d detect_unicode=0 go-pear.phar
  1. Add PEAR to your PATH variable:
export PATH=${PATH}:/Users/localadmin/pear/bin
  1. Test that it works:


Let’s install xdebug using PECL:

cd ~
sudo pecl install xdebug

Open a Terminal and let’s edit our php.ini file:

sudo nano /etc/php.ini

Now, search for ‘extension=’ using CTRL-W, then add the following under the existing comment section:


And finally restart Apache:

sudo apachectl restart


Install mCrypt:

  1. Open a Terminal and enter:
cd ~
mkdir ~/mcrypt
cd ~/mcrypt
curl -O
  1. Determine the version of PHP installed:
php -v

As of Mavericks 10.9.2 PHP is running at version 5.4.24. If your version varies, please adjust the file names in the following steps accordingly.

  1. Download the appropriate source code in tar.gz for your php version into the mcrypt folder.
  2. Expand both files and remove the archives:
cd ~/mcrypt
tar -zxvf libmcrypt-*.tar*
tar -zxvf php-*.tar*
rm *.tar*
  1. Install autoconf:
cd ~/mcrypt
curl -O
tar xvfz autoconf-latest.tar.gz
rm autoconf-l*.gz
cd autoconf-*
sudo make install
  1. Configure libmcrypt:
cd ~/mcrypt/libmcrypt-*
sudo make install
  1. Compile PHP mcrypt extension:
cd ~/mcrypt/php-*/ext/mcrypt/

The output should look something like the following:

PHP Api Version: 20100412
Zend Module Api No: 20100525
Zend Extension Api No: 220100525
sudo make install

This should result in the following text at the end:

Libraries have been installed in: /Users/localadmin/mcrypt/php-5.4.24/ext/mcrypt/modules
  1. Add the module to php.ini:
sudo nano /etc/php.ini

If this file is empty, CTRL-X out of nano, and do the following, then nano back into php.ini with the above command (otherwise skip this):

sudo cp /etc/php.ini.default /etc/php.ini
sudo chmod u+w /etc/php.ini

Look for ‘extension=’ using CTRL-W again, and add the following under any existing entries:

Look for the extension_dir declaration using CTRL-W. It should look something like this:

extension_dir = “/usr/lib/php/extensions/no-debug-non-zts-20100525/”
  1. Restart Apache:
sudo apachectl restart
  1. Verify that mcrypt is installed, by searching through the output for crypt (open a new Terminal window using CMD-T, then type the following command, then use CMD-F to find ‘mcrypt’):
php -i
  1. Delete the mcrypt folder we used for installation:
cd ~
rm -R mcrypt


(Optional) If your project uses MongoDB, you will need to install it as well:

  1. Install the latest version of MongoDB:
mkdir ~/mongo
cd ~/mongo
curl -O
tar -zxvf mongodb-osx-x86_64-2.4.9.tgz
sudo mkdir -p /usr/local/mongodb-osx-x86_64-2.4.9
  1. Then (commands are separated to ensure that the sudo password isn’t filled in by accident):
sudo cp -R -n mongodb-osx-x86_64-2.4.9/ /usr/local/mongodb-osx-x86_64-2.4.9
sudo mkdir /data
sudo mkdir /data/db
sudo chown `id -u` /data/db
sudo ln -s /usr/local/mongodb-osx-x86_64-2.0.0/ /usr/local/bin/mongodb
  1. Add the binaries to your PATH variable:
export PATH=${PATH}:/usr/local/mongodb/bin
  1. Test that MongoDB works:
cd ~

It should start the mongodb service and wait for a connection. Open your browser to connect.

  1. Download and install the MongoDB Preferences Pane. This will help with automatic startup on boot, etc. (Unfortunately it won’t allow you to configure automatic start on boot, but that seems to be planned.) Add

as the binary location, and turn it on. You will have to do this after each reboot.

PHP mongo Module

(Optional) Install PHP-mongo module, if you installed MongoDB.

  1. Install php-mongo:
sudo pecl install mongo
  1. Add extension to php.ini:
sudo nano /etc/php.ini

Paste the following right below the mysql module we added earlier:

Then CTRL-X and save to exit.

  1. Verify that php-mongo is installed, open a new Terminal:
php -i

Search for ‘mongo’ using CMD-F.

Web Server

Now we need to install the web server:

  1. Open Server App, and go to the first item, typically named after your computer.
  2. Change your Host name to the url you want your machine accessed by.
  3. Change your computer name to something that makes sense.
  4. Next, click on the Websites menu item, but turn the service on yet.
  5. Make sure that ‘Enable PHP web applications’ is checked.


Download PHPCI:

  1. Open a Terminal:
cd /Library/Server/Web/Data/Sites
sudo git clone
  1. Set ownership of files to your user and make composer.json writable.:
sudo chmod -R +a '_www allow read,write,delete,add_file,add_subdirectory,file_inherit,directory_inherit' PHPCI
sudo chmod 766 composer.json

Configure your web site:

  1. If you want to host on a port other than 80, create a new website. Otherwise open the default web site settings by double-clicking on it.
  2. Set the following items:
  3. Specify the root folder as ‘/Library/Server/Web/Data/Sites/PHPCI/public’
  4. Edit Advanced Settings and make sure that .htaccess overrides are turned on.
  5. Press OK.
  6. Back at the terminal, edit the appropriate vhosts file in ‘/Library/Server/Web/Config/apache2/sites/’. If you are using the default site on port 80, it will be called 0000_any_80_.conf. Example:
sudo nano /Library/Server/Web/Config/apache2/sites/0000_any_80_.conf
  1. Make the following changes:
  2. Change the DocumentRoot to "/Library/Server/Web/Data/Sites/PHPCI/public".
  3. Change the Directory directive to <Directory "/Library/Server/Web/Data/Sites/PHPCI">.
  4. Change AllowOverride to All.
  5. Add the following before the closing tag:
              RewriteEngine On
              RewriteCond %{REQUEST_FILENAME} !-f
              RewriteCond %{REQUEST_FILENAME} !-d
              RewriteRule . /index.php [L]
  1. Install Composer locally to PHPCI:
cd /Library/Server/Web/Data/Sites/PHPCI
sudo curl -sS | sudo php
sudo mv composer.phar composer
sudo chmod +x composer
  1. Let’s make sure the project vendors are installed and updated:
sudo ./composer update
  1. Run the following command to finish the installation on the Terminal (this will help to determine if any errors occur, as you wouldn’t be able to tell using the web interface):
cd /Library/Server/Web/Data/Sites/PHPCI/
sudo ./console phpci:install
  1. Back in Mavericks Server App, go to Web Sites, and turn the service on.
  2. You should now be able to browse to your PHPCI server by clicking on the arrow at the bottom, by default called ‘View Server Website’.
  3. If everything is working as expected, rename the install.php file for security:
sudo mv /Library/Server/Web/Data/Sites/PHPCI/public/install.php /Library/Server/Web/Data/Sites/PHPCI/public/install.old

First Time Builds with GIT

The first time you add a project from a new git repository, be sure to run the build manually, as you might otherwise encounter the following error:

Failed to clone remote git repository.

To get around this, schedule a build in PHPCI, then run the build command manually:

sudo /usr/bin/php /Library/Server/Web/Data/Sites/PHPCI/console phpci:run-builds

This will add the RSA key for your git repo host to your key file, essentially telling the system that you trust this server. (This is discussed in detail in issue #114.)

Automatic Builds with Cron Jobs

Perform the following command in a Terminal to enable the automatic build process:

env EDITOR=nano crontab -e

Then paste the following:

* * * * * sudo /usr/bin/php /Library/Server/Web/Data/Sites/PHPCI/console phpci:run-builds

Hit CTRL-X, save and quit. Now PHPCI will monitor every minute for pending jobs and fire them off.