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