A short article to install redmine on debian 6.0. Redmine is a powerful project manager written in Ruby.
Installation will be easy using debian repository.


First you need a db, a classic way is to use mysql.

apt-get install mysql-server

After you need redmine and the connector mysql


apt-get install redmine redmine-mysql


Then you can install the configuration into Apache.
If you never have installed apache, the command :

apt-get install apache2

Then you can install the custom module

apt-get install libapache2-mod-passenger

Install a lib util for ruby.

apt-get install librmagick-ruby

Then we want to configure a custom virtual host into apache to redirect requests on port 3000 for redmine

we copy the example config and customise it :

To copy :

cp /usr/share/doc/redmine/examples/apache2-passenger-alias.conf /etc/apache2/sites-available/redmine
And you change lines on top to ad port 3000.


Listen 3000
# Listen for virtual host requests on all IP addresses
NameVirtualHost *:3000


<VirtualHost *:3000>
# ServerName my.domain.name
# this is the passenger config
RailsEnv production
SetEnv X_DEBIAN_SITEID "default"
SetEnv RAILS_RELATIVE_URL_ROOT "/redmine"
# apache2 serves public files
DocumentRoot /usr/share/redmine/public
Alias "/redmine/plugin_assets/" /var/cache/redmine/default/plugin_assets/
Alias "/redmine" /usr/share/redmine/public
<Directory "/usr/share/redmine/public">
Order allow,deny
Allow from all
</Directory>
</VirtualHost>

You enable the site configuration :

a2ensite redmine

and restart apache

/etc/init.d/apache2 restart

Finally you can test into your browser :

http://localhost:3000

The home page will be present without error message.

NB : If a problem exists during the installation, you can reconfigure redmine by using this command :

dpkg-reconfigure - plow redmine