HowTo install Redmine on CentOS 5 » History » Version 1

Version 1/115 - Next » - Current version
Serafim J Fagundes, 2010-12-28 17:23
First version of the page


  • Apache is up and running
  • Apache has previously been used and works quite well
  • MySQL is up and running
  • MySQL has previously been used and works quite well
  • Your are logged as root
  • The next steps are done successively without errors

Get Ruby

cd ~/Downloads # YOUR FOLDER OF CHOICE
cd /pub/ruby
get ruby-1.8.7.pXXX.tar.gz
tar zxvf ruby-1.8.7.pXXX.tar.gz ruby-1.8.7.pXXX
cd ruby-1.8.7.pXXX
make install
ruby -v
which ruby
cd ..

Get Gems

tar zxvf rubygems-1.x.tgz rubygems-1.x
cd rubygems-1.x
ruby setup.rb
gem -v
which gem
cd ..

Install Passenger

gem install passenger

Restart Apache

Download Redmine

tar zxvf redmine-1.x.tar.gz redmine-1.x

Copy the folder to its HTTP document root folder

cp redmine-1.x /var/www/redmine-1.x

Configure Apache to host the documents

Install Bundler

gem install Bundler

Add the Bundler Boot and preinitializer code

(For more info go to the Bundler site )

Create the Gemfile and register these gems in it

  • "rake", "0.8.3"
  • "rack", "1.0.1"
  • "i18n", "0.3.7"
  • "rubytree", "0.5.2", :require => "tree"
  • "RedCloth", "~>4.2.3", :require => "redcloth" # for CodeRay
  • "mysql"

bundle install

Create the Redmine MySQL database

Configure database.yml (rename database.yml.example)

Set the production environment (optional)

Uncomment the following line:

ENV['RAILS_ENV'] ||= 'production'

Generate the session store

RAILS_ENV=production bundle exec rake generate_session_store

Migrate the database models

RAILS_ENV=production bundle exec rake db:migrate

Load default data (optional)

RAILS_ENV=production bundle exec rake redmine:load_default_data

Follow instructions.

Rename dispatch CGI files

mv dispatch.cgi.example dispatch.cgi
mv dispatch.fcgi.example dispatch.fcgi
mv dispatch.rb.example dispatch.rb

Edit .htaccess file for CGI dispatch configuration

Chown and Chmod files for read/write access for the Apache user

cd ..
chown -R apache:apache redmine-1.x
chmod -R 755 redmine-1.x

Redmine should be fully installed now and fully usage