How to install Redmine 2.5 on CentOS 6.5

This installation assumes that You have already Apache 2.2 and MySQL 5.x up and running.

Ruby 2.1

For whole operation we’ll need to install Development Tools, which can be done by:

yum groupinstall development

Then we’ll install ruby 2.1.x via rvm

curl -L | bash -s stable
source /etc/profile.d/

Now we’ll have to reload rvm and install ruby

rvm reload
# this will install newest tag from 2.1 branch
rvm install 2.1

Now we want to make this version as default and this is done by:

rvm use 2.1.x --default

Phusion Passenger

To run Redmine we’ll need Passenger with it’s Apache module.

gem install passenger

Installer will guide You through process. At the end You’ll need to add /etc/httpd/conf.d/passenger.conf :

LoadModule passenger_module /usr/local/rvm/gems/ruby-2.1.1/gems/passenger-4.0.41/buildout/apache2/
<IfModule mod_passenger.c>
    PassengerRoot /usr/local/rvm/gems/ruby-2.1.1/gems/passenger-4.0.41
    PassengerDefaultRuby /usr/local/rvm/gems/ruby-2.1.1/wrappers/ruby

Of course versions may vary depending on when You’re doing this. Installer will however give You this details.

Redmine 2.5

Download latest version from Redmine official webpage by wget and untar it:

tar xzvf redmine-2.5.1.tar.gz
mv redmine-2.5.1 /var/www/html/redmine

Now it’s time to configuration. Let’s start from database. Edit config/database.yml and pass there Your database credentials

 adapter: mysql2
 database: redmine
 host: localhost
 username: redmine
 password: redmine
 encoding: utf8

Next we’ll setup mail delivery data. Edit config/configuration.yml

 delivery_method: :smtp
 address: "localhost"
 port: 25
 authentication: :login
 domain: ''
 user_name: ''
 password: 'YourSecretPassword.600'

It’s time to bundle our Redmine:

bundle install --without development test
bundle exec rake generate_secret_token
RAILS_ENV=production bundle exec rake db:migrate

Then we’ll have to change ownership of /var/www/html/redmine

chown -R apache. /var/www/html/redmine

Configure Apache

It’s time to add VirtulaHost to Your Apache instance

<VirtualHost *:80>
 DocumentRoot /var/www/html/redmine/public

 <Directory /var/www/html/redmine/public>
   AllowOverride all
   Options -Multiviews

Now restart Apache and You’re good to go !

service httpd graceful

Yay! Now You can login by passing admin/admin credentials. Have Fun!


11 thoughts on “How to install Redmine 2.5 on CentOS 6.5

  1. nice tutorial!

    I have read many more but this is the most updated I have found

    On question though

    Why do you install ruby with rvm instead of doing “yum install ruby” ?

    I keep asking myself that

  2. Koliya Pulasinghe says:

    “yum group install development” :- should be chnaged as “yum groupinstall -y development” since the the previous command did not work in CentOs 6.5.

  3. i’m using CentOS 6.5, as per the instruction i installed up to redmine 2.5 and edited both files(database.yml and configuration.yml) also. then i started bundle, but i cant execute the commands given below

    bundle install –without development test
    bundle exec rake generate_secret_token

    please give me a solution for bundle redmine.

    • Can’t help You without further information about what does it mean that You can’t execute these commands… errors usually give hints what’s wrong.

  4. I have install redmine on centos 6.5. I have install successfully everything, but I whenever I am running redmine it just show directory listing for redmine package. I have also noticed that redmine and httpd is working on same port. If I mention load remine.conf in httpd.cof file then httpd stop to work. Please suggest and help me on this.

  5. # bundle install –without development test

    Gem::Ext::BuildError: ERROR: Failed to build gem native extension.
    An error occurred while installing rmagick (2.13.3), and Bundler cannot continue.
    Make sure that `gem install rmagick -v ‘2.13.3’` succeeds before bundling.

    # gem install rmagick -v 2.13.3
    Can’t install RMagick 0.0.0. You must have ImageMagick 6.4.9 or later.
    # yum install ImageMagic-devel
    and re-try
    # gem install rmagick -v 2.13.3
    Can’t install RMagick 0.0.0. You must have ImageMagick 6.4.9 or later.

    How can I fix it ?

    Help me please

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s