How to install Redmine with cPanel

Although Redmine do provide the installation guide as URL as below, however it might not work if you are using cPanel.

With this article, you may get a complete guide to install Redmine to cPanel server with Ruby on Rails running.

– Ruby On Rails 1.8.x enabled, please downgrade to 1.8.x if your are running higher than that. To check the Ruby version, type “ruby -v” from shell.
– Shell Access(SSH) enabled
– MySQL Enabled

1. Install gem rails version 2.3.5(exact version), from SSH shell, run “gem install rails -v=2.3.5”.
2. Install gem rack version 1.0.1(or higher version), from SSH shell, run “gem install rack”.
3. Install gem rubygems 1.3.1(or higher version), from SSH shell, run “rubygems-update”. If it is not working, refer to
4. Create MySQL database from your cPanel and I assume that you are using the database as detail below.
Database Name: mickgenie_redmine
Username: mickgenie_redmine
Password: StR0NgPa$$w0Rd

Installation Step:
1. Log into the cPanel, click on Ruby On Rails.
2. In the App Name, enter Redmine, environment session select Production and create the App.
3. Click on Create Rewrite button and enter the subdomain or path that needed, then save it.
4. Download Redmine from RubyForce.
5. Upload through File Manager according to the path that you created from the Ruby On Rails.
6. Extract the file to the RoR Apps.
7. Log into the SSH, run “rake gems:install” from the Ruby Apps path, for more information, please refer to URL at here.
8. Rename the in config/database.yml.example to config/database.yml.
9. Open the database.yml file and look for the production section.
10. Modify the production section as detail below.
adapter: mysql
database: mickgenie_redmine
host: localhost
username: mickgenie_redmine
password: StR0NgPa$$w0Rd

(These information is create as above).
11. Run “rake generate_session_store” to create session store secret.
12. Next, run “RAILS_ENV=production rake db:migrate” to get the database structure.
13. Then you may run “RAILS_ENV=production rake redmine:load_default_data” to get the default data.
14. You have done the installation, just go to cPanel and start the mongrel.

Final Step:
You may now log into Redmine with detail below,
Username: admin
Password: admin

For Redmine 1.4, please refer to the URL as below,

Published by

Mick Genie

Mick Genie is the founder of and working at ExaBytes Network Sdn Bhd and WPWebHost web host company. He is expertise in Windows and Linux environment especially web hosting related information, tips and trick as well as the IT Information.

14 thoughts on “How to install Redmine with cPanel”

  1. Hi, I have followed all steps.

    After these, i have click on RUN button in Manage Ruby On Rails Applications in Cpanel.

    But it still shows Not Running in app status.

    Please guide me whats next or I have to wait for few hours same as sub domain propagation etc.


        1. mongrel is ruby web server and normally you could get the log from your ruby Apps folder(get if from cPanel RoR) logs folder.


  2. Hi thanks for your reply.

    Here is the inside code of mongrel.log

    ** Daemonized, any open files are closed. Look at log/ and log/mongrel.log for info.
    ** Starting Mongrel listening at
    ** Starting Rails with production environment…
    ** Rails loaded.
    ** Loading any Rails specific GemPlugins
    ** Signals ready. TERM => stop. USR2 => restart. INT => stop (no restart).
    ** Rails signals registered. HUP => reload (without restart). It might not work well.
    ** Mongrel 1.1.5 available at
    ** Writing PID file to log/

    Now please guide me what to do

  3. Also, when I ran the command of loading default data
    It asks for the language.

    I wrote en and press enter and then it shows that unable to load default data.

    I am much tensed due to this installation.

    Do you know any one click installer.


  4. Try to kill the old mongrel process and restart it again through cpanel.

    To kill the mongrel process,
    ps aux | grep mongrel | grep 12003 | awk ‘{ print $2 }’ | xargs kill

    Maybe you may drop an email to me so we could look into it. 🙂

  5. Tried it, but couldn’t go any further after:

    # rake gems:install
    rake aborted!
    Don’t know how to build task ‘gems:install’

    Couldn’t find any solution to this on the net either.
    There is no “gems:install” in rake -T and I really don’t know how to put it in there

  6. I try with this tutorial. But I got confused with step 6, step 7. So I could not install redmine 🙁
    I want to install latest version of redmine. My hosting server is just host.
    as you know each and every steps, will you please publish a post for me. I guess it will not take more thn 15 min for you. IT would be a great help for me. Will you plz?

Comments are closed.