Macintosh System Requirements

You can just run setup and setup will tell you if you are missing any system component pre-requisites. This guide covers all the details of those pre-requisites needed in order for a setup to succeed.

If you are missing anything, we maintain a list of helpful links and advice.

To open a window in which you can type commands on the "command line", launch the Finder, click Applications, go to the Utilities folder, and double click Terminal. You will need this in the following steps.

Your Computer

FogBugz 6 for Macintosh runs on PowerPC and Intel Apple Macintosh computers running Mac OS X version 10.4 (Tiger) or 10.5 (Leopard). Please contact Fog Creek Software first if you need to run FogBugz on any other server.

Personal Web Sharing must be enabled.

Launch System Preferences, and click Sharing. There should be a check mark next to "Personal Web Sharing". If it is not checked, check it - this starts the Apache web server in OS X.

To verify that the web server is indeed running correctly, click this link: http://localhost and you should see a page (it may say "If you can see this, it means that the installation of the Apache web server software on this system was successful", that's a default page that comes with Apache).  

PHP Apache Module

If you are using a version of Mac OS X earlier than Leopard, use: http://www.entropy.ch/software/macosx/php/

If you are using Mac OS X Leopard, please read this guide on installing FogBugz on Leopard which uses MacPorts instead.

Must be installed with the following extensions compiled in:

• xml
• imap
• mysql
• iconv

Must be installed without the debug and ZTS options.

We recommend setting allow_call_time_pass_reference to true in your php.ini configuration file. Setting this configuration to true will ensure that the Apache logs do not get repeated warnings about a deprecated FogBugz call.

Version required: PHP 5.1 or higher

Not sure if it's installed? Open TextEdit and paste in the following text:

<?
echo PHP_VERSION . "<br>";
echo "XML:" . extension_loaded('xml') . "<br>";
echo "imap:" . extension_loaded('imap') . "<br>";
echo "mysql:" . extension_loaded('mysql') . "<br>";
echo "iconv:" . extension_loaded('iconv') . "<br>";
?>

Save this file as "test.php" and put it in your Sites folder.

Now browse to that new page with a web browser, for example to http://localhost/test.php

• If you see either the PHP source code itself, or your web browser offers to download the file to you, this means your HTTP server is not configured to run PHP files. See the PHP documentation for instructions on configuring Apache to run PHP files.
• If PHP files are running, you will see the php version in the first line. Check that it is 5.1 or later.
• The next three lines tell you whether php was compiled with xml, imap, and mysql support, respectively. If they are, you will see the number 1 after the colon. For example:

5.1.6
XML:1
imap:1
mysql:1
iconv:1

If any line is missing the 1, that means that this extension is not compiled into PHP and FogBugz will not work.

PHP Command Line Interface

Must be installed. This is a version of the PHP scripting language which runs from the command line.

The following extensions must be compiled in:

• xml
• imap
• mysql
• iconv

Version required: PHP 5.1 or later

Not sure if it's installed? The command php -v will try to run it and tell you what version you have.

Not sure if you have all the right extensions compiled in? Issue each of these commands in turn. Each one will either print the number 1 to indicate that the extension is loaded, or it will not print anything in which case the extension is not loaded.

php -r "echo extension_loaded('xml');"
php -r "echo extension_loaded('imap');"
php -r "echo extension_loaded('mysql');"
php -r "echo extension_loaded('iconv');"

If any of these commands does not print 1 you will need to recompile or configure PHP to include the appropriate extensions.

'pear' must also be in your path or in /usr/local/php/bin/pear.  Type 'which pear' to find out whether your path includes the pear binary.

More info: http://us2.php.net/manual/en/features.commandline.php

MySQL Database Server

Client and Server must be installed and running.

Version required: 4.1 or later

More info: http://www.mysql.com

http://docs.info.apple.com/article.html?artnum=303225 provides advice on how to improve MySQL performance on versions of Mac OS X Server before 10.4.7.

Not sure if it's installed and running? Type mysql at the command line.

• If you get "command not found," you probably don't have mysql installed, or it might not be in your path.
• If you get "Can't connect to local MySQL server," it's possible you only have the client installed, or it could be that the server (mysqld) is simply not running.
• If you get "Welcome to the MySQL monitor" you're probably in good shape. It should also tell you what version you're running.
• Try typing use test; at the mysql prompt. If you get the message Database changed you are definitely in good shape. Type quit to exit.

Curl Command Line Tool

Must be installed.

Not sure if it's installed? Type curl --version at the command line. If it is installed, you will see a version number. If you get the message "command not found," install curl.

More info: http://curl.haxx.se/

Mono open source .NET

Version 1.2.3 or higher must be installed.

More info: http://www.mono-project.com/

For Email Integration

For FogBugz to send email, you need an SMTP server. If you have the ability to send Internet email, you probably already have one of these somewhere.

For FogBugz to receive incoming mail, you need a POP3 server. FogBugz supports plain POP3 and secure (ssh-based) POP3. Almost all email servers support POP3.

For Source Code Control Integration

We support integration with Perforce, CVS, Subversion, Visual SourceSafe, and Vault. Other source code control systems may work if they support some form of triggers and have a web interface. More info.