Redmine

Redmine is a flexible project management web application. Written using the Ruby on Rails framework, it is cross-platform and cross-database.

Redmine is open source and released under the terms of the GNU General Public License v2 (GPL).

Requirements

Check the Redmine requirements carefuly, specially if you won't be using PostgreSQL. A few MariaDB and MySQL issues remain open.

Installation

Redmine database and application

This was tested in Debian Stretch (9).

1. Install your database:

apt install postgresql # or mysql-server

2. Install Redmine with support for your database of choice

apt install redmine-pgsql # or redmine-mysql, or redmine-sqlite

This will also install all required dependencies including Ruby libraries, etc.

There will be one or more prompts asking to confirm database configuration via dbconfig-common. The default Yes should be OK unless you are using an external database or want to otherwise manually configure this.

3. Configure the web server

apt install apache2 libapache2-mod-passenger

To use your domain for Redmine only (ie. http://domain.com/):

cp /usr/share/doc/redmine/examples/apache2-passenger-host.conf /etc/apache2/sites-available/redmine.conf

To use the same domain shared with other applications (ie. http://domain.com/redmine):

cp /usr/share/doc/redmine/examples/apache2-passenger-alias.conf /etc/apache2/sites-available/redmine.conf

Edit your configuration file to add your domain name and sysadmin contact information:

edit /etc/apache2/sites-available/redmine.conf

For example:

    ServerName exampledomain.com
    ServerAdmin admin@exampledomain.com

Next:

a2enmod passenger
a2ensite redmine.conf
a2dissite 000-default
service apache2 reload

Alternatively, to use the same domain but a different port, base your config on apache2-passenger-host.conf, then edit apache2.conf to also Listen to <port> and redmine.conf accordingly. In this case disabling 000-default is not required.

4. Log into Redmine at http://<ip>/ with the following default admin account:

username: admin
password: admin

SSL certificate

  1. Add the Debian Backports repository

  2. Follow instructions at the Certbot documentation

Differences from upstream Redmine

The Debian redmine package contains a few patches to support running multiple Redmine instances using a single codebase. You manage your instances by using dpkg-reconfigure redmine. This multi-instance support makes some things appear in places that are different from when you are using the upstream redmine:

Buster (Debian 10)

Apache 2.4.29

Create /etc/apache2/conf-available/redmine.conf

Example configuration:

Alias /redmine /your_redmine/public
<Location /redmine>
     PassengerBaseURI /redmine
     PassengerAppRoot /your_redmine/
</Location>
<Directory /your_redmine/public>
    Require all granted
    Allow from all
    AllowOverride all
    RailsBaseURI /redmine
    RailsEnv production
    Options -MultiViews
</Directory>

# a2enconf redmine
# systemctl reload apache2

Installer RVM pour installer et utiliser Redmine

Introduction

Prérequis

Créer un domaine fictif dans le cas d'un test sur une machine locale

Installer les paquets

Installation

Créer un utilisateur Redmine

Installer RVM

Préparer la base de données

Installer Redmine depuis Git

Configurer Redmine

Installer Ruby et Gems

Sélectionner le bon gemset

Installer les Gems pour Redmine

RMV et bundler intégration

Installer Phusion Passenger

Configurer le VirtualHost

Phase finale

Conclusion

En supplément

Réimporter le fichier de configuration

Réimporter le fichier de configuration de la base de données

Réimporter une base de données de Redmine et la mettre à jour

Réimporter les fichiers


CategorySystemAdministration CategorySystemAdministration