Redmine is a flexible project management web application. Written using the Ruby on Rails framework, it is cross-platform and cross-database.
OS: CentOS 6.2

  • Install packages
    yum install ruby-devel gcc-c++ openssl-devel httpd httpd-devel mysql-server  mysql-devel make ruby-rdoc libcurl-devel rubygem-rake ImageMagick ImageMagick-devel wget
  • Rubygems
    cd /tmp
    tar xvfz rubygems-1.8.24.tgz
    cd rubygems-1.8.24
    ruby setup.rb
  • Passenger
    gem install passenger

  • Load the passenger apache module. Add the following config in /etc/httpd/conf/httpd.conf
    LoadModule passenger_module /usr/lib64/ruby/gems/1.8/gems/passenger-3.0.12/ext/apache2/
    PassengerRoot /usr/lib64/ruby/gems/1.8/gems/passenger-3.0.12
    PassengerRuby /usr/bin/ruby
  • Setup apache vhost
    cat <<'EOF' > /etc/httpd/conf.d/redmine.conf
    Header always unset "X-Powered-By"
    Header always unset "X-Rack-Cache"
    Header always unset "X-Content-Digest"
    Header always unset "X-Runtime"
    PassengerMaxPoolSize 20
    PassengerMaxInstancesPerApp 4
    PassengerPoolIdleTime 3600
    PassengerUseGlobalQueue on
    PassengerHighPerformance on
    PassengerStatThrottleRate 10
    RailsSpawnMethod smart
    RailsAppSpawnerIdleTime 86400
    RailsFrameworkSpawnerIdleTime 0
    <VirtualHost *:80>
     ServerName redmine.local
     DocumentRoot /var/www/redmine/public/
     <Directory "/var/www/redmine/public/">
      Options Indexes ExecCGI FollowSymLinks
      AllowOverride all
      Order allow,deny
      Allow from all
    Note that redmine.local is a local domain and is a manual entry in my workstation's /etc/hosts file. This is done for testing purposes only. For production systems, this may very well be a subdomain under you company's domain name e.g.
  • Download and extract redmine
    cd /tmp
    tar xvfz redmine-2.0.0.tar.gz
    mkdir /var/www/redmine
    cp -a redmine-2.0.0/* /var/www/redmine
    chown -R apache.apache /var/www/redmine && chmod -R 755 /var/www/redmine
    touch /var/www/redmine/log/production.log
    chown root.apache /var/www/redmine/log/production.log
    chmod 664 /var/www/redmine/log/production.log
  • Bundle
    gem install bundler
    cd /var/www/redmine/
    bundle install --without development test postgresql sqlite
  • Setup MySQL DB
    service mysqld start
    chkconfig mysqld on
    mysql -uroot -p -e 'create database redmine character set utf8; grant all on redmine.* to redmine@localhost identified by "my_passwd";flush privileges';
  • Setup redmine database connection
    mv /var/www/redmine/config/database.yml.example /var/www/redmine/config/database.yml
    vi /var/www/redmine/config/database.yml
    # In the production section, update username, password and other parameters accordingly like so:
      adapter: mysql
      database: redmine
      host: localhost
      username: redmine
      password: my_passwd
      encoding: utf8
  • Generate token key for connections
    rake generate_secret_token
  • Migrate database models
    RAILS_ENV=production rake db:migrate
  • Load MySQL database schema and default data
    RAILS_ENV=production rake redmine:load_default_data
  • Fix plugin directory permissions
    cd /var/www/redmine
    mkdir public/plugin_assets
    chown -R apache:apache files log tmp public/plugin_assets
    chmod -R 755 files log tmp public/plugin_assets
  • and finally, start Apache
    service httpd start
    chkconfig httpd on 
  • You may now open and point your browser to http://redmine.local and login as admin/admin