Installing Redmine on Mac OS X 10.6¶

• Table of contents
• Installing Redmine on Mac OS X 10.6
  • 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')
   Set "Address" and click "Production"
3. If you are running desktop OS X (not the Server edition): See RedmineInstallOSX for more detail
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
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
   

7. Establish Defaults
   rake generate_session_store
RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data