Redmine is a flexible project management web application written using Ruby on Rails framework. It is easy to install it using CloudLinux Ruby Selector. Follow this guide to install Ruby-Selector. It works with CageFS, so make sure to enable it for the account. Redmine version described in installation instructions is different from Redmine version used. The example given describes the latest version 3.3.1 as of today. For other versions please refer to doc/INSTALL file provided with downloaded Redmine archive or to the official Installation Guide.
Setting up working environment
1. In cPanel (as a user) create MySQL database, create MySQL user and Add user to Database granting all privileges.
2. Create a new application with 'Setup Ruby Application' menu, use Ruby version 2.2. Domain root or any subdirectory can be used.
3. After the application created, add the following modules with the proper version for each. bundle bundler#1.9.9 rails#126.96.36.199
Click Update. It will take about 2 minutes to have them and dependent modules installed. 4. Install ImageMagick-devel for
Click Update. It will take about 2 minutes to have them and dependent modules installed. 4. Install ImageMagick-devel for rmagick gem:
$ yum install ImageMagick-devel
1. Log in to the server as a user (ssh or su -):
$ su -l -s /bin/bash redtest
2. Download the latest Redmine:
$ wget http://www.redmine.org/releases/redmine-3.3.1.tar.gz
3. Unpack it and move to the chosen application directory (called redmine in our example):
$ tar xfz redmine-3.3.1.tar.gz $ cp -rp redmine-3.3.1/* redmine/
4. Fill out database credentials that we have created with cPanel:
$ cd redmine $ cp config/database.yml.example config/database.yml $ vi config/database.yml
production: adapter: mysql2 database: redtest_db host: localhost username: redtest_user password: "my1passwd" encoding: utf8
5. Activate Ruby environment:
$ source ~redtest/rubyvenv/redmine/2.2/bin/activate
6. Install the modules required by Redmine:
$ bundle install --without development test
Output example: 7. Redmine stores session data in cookies by default, which requires a secret token to be generated. Do it and create database structure:
$ bundle exec rake generate_secret_token $ bundle exec rake db:migrate RAILS_ENV="production"
1. Open Redmine location URL in the browser (http://redtest.com/red3/ in our example). Use the default administrator account to log in: login: admin password: admin 2. Change your password to a new one with the proposed form. 3. Go to Administration on the top, choose preferred language and load the default configuration: Done.
* After adding some other modules to an Application with cPanel interface you may need to restart the application, which can be done on the same Ruby Selector page.