How to Install Redmine 2 - A Project Management Tool

This article will describes the steps to install Redmine Version 2. Please read it in conjunction with our article about installation of previous version of Redmine at

Please follow these steps: 
  1. Install MySQL
  2. Download RubyInstaller and Install Ruby ( )
  3. Download RubyGem and extract the package ( )
  4. Run 'ruby setup.rb' in RubyGem root folder
  5. Run 'gem install rails'
  6. Download MySQL dll from -
  7. Save this file in <ruby-installation-folder>/bin
  8. Run 'gem install mysql'
    1. It may give you an message telling from where you can get the compatible libmysql.dll. If you get this, download it from there and put in  <ruby-installation-folder>/bin
  9. Download DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe ( )
  10. Extra it in <ruby-installation-folder>/DevKit
  11. Run following commands in DevKit folder
    1. ruby dk.rb init
    2. ruby dk.rb review
    3. ruby dk.rb install
  12. Run 'bundle install --without development test rmagick postgresql sqlite'
  13. Go to MySQL prompt and run following queries
    1. create database redmine character set utf8;
    2. create user 'redmine'@'localhost' identified by 'my_password';
    3. grant all privileges on redmine.* to 'redmine'@'localhost';
  14. Go to config folder of Redmine and update database.yml file for MySQL password
  15. Run following commands to configure the database
    1. set RAILS_ENV=production
    2. rake db:migrate
    3. rake redmine:load_default_data
  16. Now Redmine is installed. You can run the server as
    1. ruby script/rails server webrick -e production
  17. Once server is started, you can access redmine at http://localhost:3000. Default admin user name and password is: 
    1. User Name - admin
    2. Password - admin
Redmine should be working fine by now. Sometime there might be problems with various gem installations. We have covered many of these cases, like:
  • 'json' native gems requires installed build tools
  • Problem in installing rmagick
  • Problem in installing mysql gem or problem while loading data
    • activerecord-mysql-adapter not found
  • If you don't have right libmysql.dll, it may result in many errors while migrating database like
    • mysql not connected
    • Incorrect buffer type used
    • Or process gets hanged
    • and so on

For more information, please refer to .

If you like the article, you may contribute by:
  • Posting your comments which will add value to the article contents
  • Posting the article link on Social Media using the Social Media Bookmark bar
  • Connecting with 'VedantaTree' on Facebook (

People who read this post also read :


Unknown said...

during installation at step : 14 while you are updating database.yml and entering password please make sure that there is a space between : and your password for e.g

password: abc123

Mohit Gupta said...

To add: run 'bundle install..' command in Redmine root directory. The required Gem file is placed there.

Mohit Gupta said...

Another good option to install Redmine can be - It is a complete installer for Redmine. For me, worked well on Windows.

Post a Comment