Installing Redmine on a CentOS 6 VPS

Today’s article will show you how you can install and setup Redmine on your CentOS 6 VPS.

Redmine is an open source, web-based project management and bug-tracking tool.

It includes a calendar and Gantt charts to aid visual representation of projects and their deadlines.

Redmine can also handle multiple projects.

It provides an integrated project management features, issue tracking system and support for various version control systems.

Make sure your operating system is fully up to date by executing:

# yum update

next, install the requirements needed for the setup (considering you already have a working LAMP installation):

# yum install make gcc gcc-c++ zlib-devel ruby-devel rubygems ruby-libs apr-devel apr-util-devel httpd-devel mysql-devel automake autoconf ImageMagick ImageMagick-devel curl-devel -y

with all that in place, we’re ready to install the bundle ruby gem by executing:

# gem install bundle

if it triggers ‘File not found: lib’, you can do:

# gem install rdoc-data
# rdoc-data --install
# gem rdoc --all --overwrite

and again execute:

# gem install bundle

if you happen to get an error such as:

/usr/include/bits/local_lim.h:39:26: error: linux/limits.h: No such file or directory
make: *** [generator.o] Error 1

then you need to install ‘kernel-headers’

if everything went fine then we’re ready to proceed with Redmine’s installation.

# cd /var/www/html
# wget http://rubyforge.org/frs/download.php/76495/redmine-2.1.2.tar.gz
# tar -zxvf redmine-2.1.2.tar.gz
# ln -s redmine-2.1.2 redmine
# rm -f redmine-2.1.2.tar.gz

# cd /var/www/html/redmine/
# bundle install --without postgresql sqlite test development

the next thing we need to do is to create a database for the Redmine installation:

# mysql -u root -p
mysql> create database redmineDB character set utf8;
mysql> grant all privileges on redmineDB.* to 'redmineUSER'@'localhost' identified by 'y0gEipo6EY';
mysql> flush privileges;
mysql> \q

and then configure Redmine’s to use the newly created database:

# cd /var/www/html/redmine/config
# cp database.yml.example database.yml

excerpt:

production:
  adapter: mysql
  database: redmineDB
  host: localhost
  username: redmineUSER
  password: y0gEipo6EY
  encoding: utf8

proceed with populating the database using:

# cd /var/www/html/redmine
# rake generate_secret_token
# rake db:migrate RAILS_ENV="production"
# rake redmine:load_default_data RAILS_ENV="production"

Next thing you need to do is to install Passenger and configure it, but before doing that you need to first install its gem by:

# gem install passenger

once it’s installed proceed with installing the apache module:

# passenger-install-apache2-module

once everything is installed you need to setup passenger’s configuration.

# cd /etc/httpd/conf.d
# vim redmine.conf

LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-3.0.18/ext/apache2/mod_passenger.so
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-3.0.18
PassengerRuby /usr/bin/ruby

<VirtualHost *:80>
  ServerName your_domain_name
  DocumentRoot /var/www/html/redmine/public
  <Directory /var/www/html/redmine/public>
    AllowOverride all
    Options -MultiViews
    allow from all
  </Directory>
</VirtualHost>

save and close the file and edit the main apache configuration file and enable name based virtual hosts by commenting out the following line:

# vim /etc/httpd/conf/httpd.conf

# Use name-based virtual hosting.

#NameVirtualHost *:80

save the file and set the ownership of your Redmine to apache by:

# chown -R apache: /var/www/html/redmine

and finally reload your webserver by executing:

# service httpd restart

next, open your ‘http://your_domain_name’ and login using ‘admin’ as username and ‘admin’ as password.

Of course you don’t have to do any of this if you use one of our Linux VPS Hosting services, in which case you can simply ask our expert linux admins to install this for you. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.