Installing Redmine on OS X Server¶

• Table of contents
• Installing Redmine on OS X Server
  • Step by Step
    • Install Prerequisites
    • Install Redmine

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: http://developer.apple.com/technologies/xcode.html
2. Install OS X MySQL Libraries ( http://support.apple.com/kb/HT4006 )
   Download http://www.opensource.apple.com/other/MySQL-53.binaries.tar.gz
   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: http://www.fngtps.com/passenger-preference-pane

Install Redmine¶

1. Checkout Redmine
   cd /Library/WebServer/Sites/
svn checkout http://redmine.rubyforge.org/svn/trunk 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.:
   

   production:
     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