Redmine

h1. Installing Redmine on Mac OS X 10.6 (Desktop — not the Server edition)

> [[RedmineInstallOSXServer|Instructions for the server edition are here]].

Since Mac OS X doesn't have the "Server Admin" application, you'll need to start & configure MySQL manually from the command line. If you have the MySQL Preference Pane installed in the System Preferences, you can start/stop MySQL from there.

Alternatively, if you are installing *for a development environment only*, you can use another instance of MySQL, such as those bundled with "MAMP":http://www.mamp.info/en/index.htm, "MAPStack":http://bitnami.org/stack/mampstack, "XAMPP":http://www.apachefriends.org/en/xampp.html, the "Acquia Drupal Stack Installer":http://acquia.com/downloads and other pre-compiled and packaged server stacks.  To do this;

# Skip the steps about:

    1. @passenger-install-apache2-module@

         • Use webrick instead only if using for development environment only, passenger has better performance. 

         • You don't need @gem install passenger@ or the Passenger preferences pane if using webrick.

    2. Enabling MySql with Server Admin

    3. Establishing defaults with rake and RAILS_ENV

# You may need to build your mysql gem if @sudo gem install mysql@ fails. For example you may try the following depending on where you have mysql installed:

  @sudo env ARCHFLAGS="-arch x86_64" gem install --no-rdoc --no-ri mysql -- --with-mysql-config=/usr/local/bin/mysql_config@

  @sudo env ARCHFLAGS="-arch x86_64" gem install --no-rdoc --no-ri mysql -- --with-mysql-config=/usr/local/mysql-5.1.34-osx10.5-x86_64/bin/mysql_config@  

# You my need to download and install MySql binaries from the opensource.apple.com link in [[RedmineInstallOSXServer]].  @gem@ needs this in order to build the ruby-to-mysql plugin. If you installed the developer's tools, this should be in place.

# Start your server-stack and check the MySQL server is running

# Either;

  1. Use the stack's phpMyAdmin or its equivalent tool to create the database and user, *OR*

  2. Check that @mysql@ on the command line points to the mysql binary for your stack (@which mysql@) and create a database and user as per [[RedmineInstallOSXServer]].

# Link Mac OS X's mysql socket to the stack's socket to trick Ruby into finding the right mysql instance:

  @sudo ln -s /Applications/acquia-drupal/mysql/data/mysql.sock /var/mysql/mysql.sock@

  - or - 

  @sudo ln -s /Applications/MAMP/tmp/mysql/mysql.sock /tmp/mysql.sock@

  - or -

  In your config/database.yml add parameter @socket: /path/to/socket.sock@

# Start the Ruby web server with @ruby script/server webrick -e production@.

    If you set the development database settings in @config/databases.yaml@ instead of the production database settings, you can replace _production_ with _development_ in the above command.

# Point your web browser at http://localhost:3000 if using webrick

Alternatively, follow the standard installation instructions at [[RedmineInstall]], making the alterations suggested in the forum post "Mac OS X - Snow Leopard installation notes" at http://www.redmine.org/boards/2/topics/17148.

There is a freely available all-in-one GUI installer for OS X that can be downloaded at http://bitnami.org/stack/redmine

See also the [[How to install Redmine in Linux Windows and OS X using BitNami Redmine Stack|BitNami Redmine on OS X tutorial]]