RedmineInstallOSXServer » History » Version 6

« Previous - Version 6/12 (diff) - Next » - Current version
Art Kuo, 2011-06-09 01:46
Clarified how to extract MySQL binaries. The download is an archive, which when extracted, yields another archive to be extracted. Also found some gem versions needed to be explicitly stated for compatibility with redmine.

Installing Redmine on Mac OS X 10.6

This is a quick summary of the necessary steps for a simple install of Redmine on Apple OS X Snow Leopard Server 10.6.4. It is meant only as a supplement, not a replacement, to the official install guide found here.

Step by Step

Install Prerequisites

  1. Install Xcode/OS X Developer Tools
    Install from OS X Server DVD that was shipped with your Mac, or register for a free account and download from:
  2. Install OS X MySQL Libraries ( )
    Download (or MySQL-54 for OSX 10.6.7)
    sudo tar -xvf ~/Downloads/MySQL-53.binaries.tar -C ~/Downloads
    or if you downloaded a .gz file,
    sudo tar -xzvf ~/Downloads/MySQL-53.binaries.tar.gz -C ~/Downloads
    This will produce a root.tar archive, which must then be extracted
    sudo tar -xzvf ~/Downloads/MySQL-53.binaries/MySQL-53.root.tar.gz -C /
    If successful, tar should list the many files being placed in appropriate locations
  3. Install Ruby Gems
    sudo gem install rails -v=2.3.5
    sudo gem install rack -v=1.0.1
    sudo gem install rake -v=0.8.3
    sudo gem install fastthread
    sudo gem install mysql -v=2.8.1 (may also help to use env ARCHFLAGS="-arch x86_64")
  4. If you are running desktop OS X (not the Server edition): See RedmineInstallOSX
  5. If you are running OS X Server: Install Passenger
    sudo gem install passenger
    sudo passenger-install-apache2-module
    The apache2 module installation will ask you to add several lines to the apache configuration file. Some likely locations for this are /etc/apache2/httpd.conf (standard OS X Server installation) and /opt/local/apache2/conf/httpd.conf (MacPorts installation).
  6. Install Passenger Pref Pane
    Download and Install:

Install Redmine

  1. Checkout Redmine
    cd /Library/WebServer/Sites/
    sudo svn checkout redmine
  2. Configure Passenger
    Open /Library/WebServer/Sites/redmine in Finder
    Start Passenger preference pane in System Preferences
    Drag redmine folder to Passenger (you may have to 'click to make changes')
    Set "Address" and click "Production"
  3. If you are running desktop OS X (not the Server edition): See RedmineInstallOSX
  4. If you are running OS X Server: Enable MySQL
    Launch Server Admin, click + Sign, Add Service, Check MySQL box, click Save
    Choose the MySQL service, click Set Root Password, click Start to start the service
  5. Setup Database
    mysql -u root -p
        create database redmine character set utf8;
        create user 'redmine'@'localhost' identified by 'my_password';
        grant all privileges on redmine.* to 'redmine'@'localhost';
  6. Configure Redmine
    cd /Library/WebServer/Sites/redmine
    sudo mkdir tmp public/plugin_assets
    sudo chmod -R 755 files log tmp public/plugin_assets
    sudo cp config/database.yml.example config/database.yml
    Edit database.yml, ie.:
      adapter: mysql
      database: redmine
      host: localhost
      username: redmine
      password: my_password
  7. Establish Defaults
    sudo rake generate_session_store (may require gems i18n and updated rails)
    sudo RAILS_ENV=production rake db:migrate
    RAILS_ENV=production rake redmine:load_default_data