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, "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 run the following command instead of @sudo gem install mysql@ — I'm not sure.

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

# You'll still 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.

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

# Either;

  1. Use the stack's phpMyAdmin or it's 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 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@

# 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