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

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, MAPStack, XAMPP, the Acquia Drupal Stack Installer and other pre-compiled and packaged server stacks. To do this;

  1. 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
  1. 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
  2. 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.
  3. Start your server-stack and check the MySQL server is running
  4. 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.
  5. 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
  1. 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.
  2. 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 BitNami Redmine on OS X tutorial