RedmineInstallOSXServer » History » Version 1

Version 1/12 - Next ยป - Current version
Josh Galvez, 2010-08-18 22:30
First Draft

Installing Redmine on OS X Server

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 ( )
    sudo tar -xvf ~/Downloads/MySQL-53.binaries.tar -C /
  3. Install Ruby Gems
    sudo gem install rails -v=2.3.5
    sudo gem install rack -v=1.0.1
    sudo gem install rake
    sudo gem install fastthread
    sudo gem install mysql
  4. Install Passenger
    sudo gem install passenger
    sudo passenger-install-apache2-module
  5. Install Passenger Pref Pane
    Download and Install:

Install Redmine

  1. Checkout Redmine
    cd /Library/WebServer/Sites/
    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')
  3. 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
  4. 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';
  5. Configure Redmine
    cd /Library/WebServer/Sites/redmine
    mkdir tmp public/plugin_assets
    sudo chmod -R 755 files log tmp public/plugin_assets
    cp config/database.yml.example config/database.yml
    Edit databse.yml, ie.:
      adapter: mysql
      database: redmine
      host: localhost
      username: redmine
      password: my_password
  6. Establish Defaults
    rake generate_session_store
    RAILS_ENV=production rake db:migrate
    RAILS_ENV=production rake redmine:load_default_data