How to run Redmine with Ruby-Selector

Preface

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

add user to db

2. Create a new application with ‘Setup Ruby Application’ menu, use Ruby version 2.2 . Domain root or any subdirectory can be used .

Setup Ruby App

3. After the application created, add the following modules with the proper version for each.

bundle

bundler#1.9.9

rails#4.2.7.1

adding bundle bundler and rails modules

Click Update. It will take about 2 minutes to have them and dependent modules installed.

4. Install ImageMagick-devel for rmagick gem:

Deploying Redmine

1. Log in to server as user (ssh or su -):

2. Download the latest Redmine:

3. Unpack it and move to the chosen application directory (called redmine in our example):

4. Fill out database credentials that we created with cPanel:

5. Activate Ruby environment:

6. Install the modules needed by Redmine:

Output example:

bundle install progress

7. Redmine stores session data in cookies by default, which requires a secret token to be generated. Do it and create database structure:

First login

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:

redmine administration

Done.

Additional notes:

* After adding some other modules to an Application with cPanel interface you may need to restart application, which can be done on the same Ruby-Selector page.

Leave a Reply

Your email address will not be published. Required fields are marked *