Redmine is a free and 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. It handles multiple projects. Redmine provides integrated project management features, issue tracking, and support for various version control systems.

Redmine is written using the Ruby on Rails framework. It is cross-platform and cross-database.

Prerequisites

This document will guide you through the installation process of the Redmine and all of its prerequisites, including the optional ones. If desired, however, you may install Redmine and it's prerequisites separately, simply refering to the relevant sections below.

Although this guide will go through all the installation process, this isn't a one way path. So Redmine can use different versions of the other softwares (mariaDB, mySQL, postgreSQL, etc, as your database).

At this time is important to note that this guide is an default suggestion, feel free to use other of the prerequisites mentioned on this wiki, and to expand this guide.

Ruby

Redmine version

Supported Ruby versions

Rails version used

Supported RubyGems versions

2.2.3

ruby 1.8.7, 1.9.2, 1.9.3

Rails 3.2.12

RubyGems <= 1.8

jruby-1.6.7

TODO: list and explain Ruby and RVM installation.

Database

MariaDB 5.0 or higher (recommended)

make sure to install the C bindings for Ruby that dramatically improve performance. You can get them by running gem install mysql2.

MySQL 5.0 or higher

make sure to install the C bindings for Ruby that dramatically improve performance. You can get them by running gem install mysql2.

PostgreSQL 8.2 or higher

make sure your database datestyle is set to ISO (Postgresql default setting). You can set it using: ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";
some bugs in PostgreSQL 8.4.0 and 8.4.1 affect Redmine behavior (#4259, #4314), they are fixed in PostgreSQL 8.4.2

Microsoft SQL Server *new*

support is planned for 2.3.0 release (but is already available on trunk for early adopters)