RedmineInstallOSXServer » History » Version 9

Version 8 (Art Kuo, 2011-06-09 02:21) → Version 9/12 (Art Kuo, 2011-06-09 02:22)

h1. 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 (or 10.6.7). It is meant only as a supplement, not a replacement, to the official install guide found [[RedmineInstall|here]].

h2. Step by Step

h3. Install Prerequisites

# 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:
# 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
# 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 env ARCHFLAGS="-arch x86_64" gem install mysql -v=2.8.1@
# If you are running desktop OS X (not the Server edition): See [[RedmineInstallOSX]]
# 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).
# Install Passenger Pref Pane
Download and Install:

h3. Install Redmine

# Checkout Redmine
@cd /Library/WebServer/Sites/@
@sudo svn checkout redmine@
# 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"
# If you are running desktop OS X (not the Server edition): See [[RedmineInstallOSX]]
# 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
# Setup Database
@mysql -u root -p@
<pre> create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'my_password';
grant all privileges on redmine.* to 'redmine'@'localhost';</pre>
# 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
# 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@
(If rails cannot access log file, do this: @sudo chmod 0666 log/production.log@)

h3. Try out using webrick

# Run the ruby web server with

@ruby script/server webrick -e production@ production
# Go to a web browser and view @http://localhost:3000@
There may be some errors. An error regarding undefined "csrf_meta_tag" can be dealt with by deleting the corresponding line in app/views/layouts/base.rhtml (perhaps line 8, but use the error message to be sure of proper line).