HowTo Install Redmine using Debian package » History » Version 12

« Previous - Version 12/21 (diff) - Next » - Current version
Jérémy Lal, 2011-03-01 01:05

HowTo Install Redmine using Debian package

A redmine debian package is available in squeeze, sid and lenny-backports
  • automatic database configuration,
  • multiple instances support.

The core package is redmine.
Three packages (redmine-*) provide correct dependencies for mysql, pgsql, sqlite.

Several configurations are given as working examples in :

Explanations of how the configuration is dealt with are given in :

There is no per-instance support for plugins, but those dropped to :
should be ok.
The migrate_plugins task is called upon each (re)configuration or upgrade.
Since custom plugins are often bound to a specific redmine version, it is advised
to remove them before upgrades.

Installation details

Install the necessary packages

From root console:

apt-get install mysql
during mysql setup, provide a new root password for mysql

apt-get install redmine
during redmine install, select mysql database with local connection, set the admin password for redmine_default database

Correct the bug (wrong display):

vi $redmine_dir/vendor/rails/activesupport/lib/active_support/vendor.rb

and modify from
gem 'i18n', '>= 0.1.3'
gem 'i18n', '>= 0.1.3', '< 0.4.0'
apt-get install libapache2-mod-passenger

Do some configuration

ln -s /usr/share/redmine/public /var/www/redmine
chown -R www-data:www-data /var/www/redmine
echo "RailsBaseURI /redmine" > /etc/apache2/sites-available/redmine
a2ensite redmine
/etc/init.d/apache2 reload
/etc/init.d/apache2 restart

Configure email smtp server

Copy from template:
cp /usr/share/doc/redmine/examples/email.yml.example /etc/redmine/default/mail.yml

Edit (at the end, there are uncommented production / development blocks to be filled in):
vi /etc/redmine/default/mail.yml

Run the browser

Open http://localhost/redmine

Log in as admin / admin

Futher configuration - SVN

Get the API key (settings / repositories)

Make a crontab to have repositories generated in the background:

crontab -e

In the editor, paste the following (this runs the scan of the projects and if needed it creates the svn repositories):
/5 * * * * /usr/bin/ruby /usr/share/redmine/extra/svn/reposman.rb --redmine localhost/redmine --svn-dir /usr/home/svn --owner www-data --group www-data --url file:///usr/home/svn --verbose --key=YOUR_API_KEY_HERE --command="/usr/bin/svnadmin create" >> /var/log/reposman.log

Configure servername/svn, so that svn repositories are available over apache webdav:

fix the bug in {{count}} display

vi $redmine_dir/vendor/rails/activesupport/lib/active_support/vendor.rb

and modify from
gem 'i18n', '>= 0.1.3'
gem 'i18n', '>= 0.1.3', '< 0.4.0'