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
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:
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.