Installer et configurer Redmine sur Ubuntu 18.04

Important : ce guide cible Ubuntu 18.04 et la version des paquets disponibles dans ses dépôts. Pour une version plus récente d’Ubuntu ou pour une installation en production, examinez les exigences spécifiques et envisagez d’installer Redmine depuis les sources pour plus de contrôle.

Qu’est‑ce que Redmine

Redmine est une application web de gestion de projet libre et open source, multi‑projets, basée sur Ruby on Rails. Elle offre suivi du temps, wiki, gestion documentaire et intégration avec des systèmes de contrôle de version (Git, SVN, CVS). Définition rapide : Redmine = gestion de projets + suivi + intégration VCS.

Variantes d’intention recherchée

• installer redmine ubuntu 18.04
• configurer redmine apache passenger
• redmine mariadb ubuntu
• redmine guide d’installation

Fonctionnalités clés

• Support multilingue
• Support de plusieurs bases de données et suivi du temps
• Intégration news, documents et gestion des fichiers
• Flux web (feeds) et notifications par e‑mail

Pré‑requis

• Un serveur Ubuntu 18.04 fonctionnel
• Un utilisateur non root disposant de privilèges sudo
• Un nom de domaine (fortement recommandé) et accès DNS pour le serveur

Installer Apache et MariaDB

Redmine s’exécute dans un serveur web et utilise MariaDB pour stocker les données. Installez Apache, MariaDB et Passenger :

sudo apt-get install apache2 mariadb-server libapache2-mod-passenger -y

Démarrez et activez les services :

sudo systemctl start apache2
sudo systemctl start mariadb
sudo systemctl enable apache2
sudo systemctl enable mariadb

Sécuriser MariaDB

Par défaut, MariaDB n’est pas sécurisé. Lancez le script de configuration sécurisée :

sudo mysql_secure_installation

Répondez aux questions comme suit (exemple) :

    Enter current password for root (enter for none):
    Set root password? [Y/n]: N
    Remove anonymous users? [Y/n]: Y
    Disallow root login remotely? [Y/n]: Y
    Remove test database and access to it? [Y/n]:  Y
    Reload privilege tables now? [Y/n]:  Y

Note : adaptez selon votre politique de mot de passe et accès distant.

Installer Redmine depuis les paquets Ubuntu

Le paquet redmine est disponible dans le dépôt par défaut d’Ubuntu 18.04. Installez Redmine et le connecteur MySQL/MariaDB :

sudo apt-get install redmine redmine-mysql -y

Pendant l’installation, le paquet vous demandera de configurer Redmine :

Cliquez sur le bouton “Yes” pour permettre la configuration automatique.

Sélectionnez la base de données “mysql” dans l’interface de configuration :

Fournissez ensuite le mot de passe MySQL pour l’utilisateur Redmine créé par le paquet :

Installer bundler et préparer les liens

Installez la gem bundler si nécessaire :

sudo gem install bundler

Créez un lien symbolique vers le répertoire public de Redmine pour l’exposer via Apache :

sudo ln -s /usr/share/redmine/public /var/www/html/redmine

Créez le fichier Gemfile.lock et donnez les permissions appropriées :

sudo touch /usr/share/redmine/Gemfile.lock
sudo chown www-data:www-data /usr/share/redmine/Gemfile.lock
sudo chown -R www-data:www-data /var/www/html/redmine

Configurer Apache pour Redmine

Éditez le fichier passenger.conf :

sudo nano /etc/apache2/mods-available/passenger.conf

Mettez ou vérifiez ces paramètres :

  PassengerDefaultUser www-data
  PassengerRoot /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini
  PassengerDefaultRuby /usr/bin/ruby

Créez un hôte virtuel Apache pour Redmine :

sudo nano /etc/apache2/sites-available/redmine.conf

Collez la configuration suivante et remplacez example.com par votre domaine :

     ServerAdmin [email protected]
     DocumentRoot /var/www/html/redmine
     ServerName example.com
     ServerAlias www.example.com

     
         RailsBaseURI /redmine
         PassengerResolveSymlinksInDocumentRoot on
     

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

Activez le site et le module rewrite :

sudo a2ensite redmine
sudo a2enmod rewrite

Rechargez Apache :

sudo systemctl restart apache2

Vérifiez l’état d’Apache :

sudo systemctl status apache2

Exemple de sortie :

Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
Drop-In: /lib/systemd/system/apache2.service.d
??apache2-systemd.conf
Active: active (running) since Wed 2019-01-16 17:43:29 CET; 8s ago
Process: 7401 ExecStop=/usr/sbin/apachectl stop (code=exited, status=0/SUCCESS)
Process: 7407 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
Tasks: 77 (limit: 2313)
CGroup: /system.slice/apache2.service
??7455 /usr/sbin/apache2 -k start
??7456 Passenger watchdog
??7459 Passenger core
??7468 Passenger ust-router
??7482 /usr/sbin/apache2 -k start
??7483 /usr/sbin/apache2 -k start

Jan 16 17:43:29 server1 systemd[1]: Starting The Apache HTTP Server...
Jan 16 17:43:29 server1 systemd[1]: Started The Apache HTTP Server.

Accéder à l’interface Web de Redmine

Ouvrez votre navigateur et allez à l’URL de l’installation, par ex. http://example.com. Vous devriez voir la page d’accueil de Redmine :

Cliquez sur “Sign In” pour vous connecter :

Identifiants par défaut :

• Nom d’utilisateur : admin
• Mot de passe : admin

Changez immédiatement le mot de passe administrateur via l’interface :

Après connexion, vous verrez le tableau de bord :

Félicitations — Redmine est installé et accessible.

Vérifications post‑installation (checklist)

• Changer le mot de passe administrateur
• Vérifier les logs Apache (/var/log/apache2/error.log)
• Configurer HTTPS (Let’s Encrypt ou certificat commercial)
• Restreindre l’accès à MariaDB depuis l’extérieur
• Programmer des sauvegardes régulières de la base de données et du répertoire files de Redmine

Playbook court (ordre minimal d’actions)

1. Installer Apache, MariaDB et Passenger
2. Sécuriser MariaDB
3. Installer le paquet Redmine + redmine-mysql
4. Installer bundler, créer le lien symbolique et ajuster les permissions
5. Configurer Apache (passenger.conf + site redmine.conf)
6. Redémarrer Apache, vérifier l’accès, changer le mot de passe admin
7. Activer HTTPS et sauvegardes

Résolution des problèmes courants

• Erreur Passenger / 500 Internal Server Error : vérifier permissions, propriétaire www-data et présence de Gemfile.lock.
• Échec de connexion à la base de données : vérifiez les identifiants dans /etc/redmine/default/database.yml ou les logs MariaDB.
• Page blanche / styles cassés : vérifier que le répertoire public est correctement lié et lisible par www-data.
• Pare‑feu : si UFW est activé, permettre le port 80/443 :

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

Sécurité et conformité (notes rapides)

• Changez le mot de passe administrateur par défaut
• Activez HTTPS (certificat TLS) avant mise en production
• Restreignez l’accès MariaDB (bind‑address) et autorisations des comptes SQL
• Sauvegardez la base et le dossier “files” de Redmine régulièrement
• Confidentialité et GDPR : limitez les données personnelles stockées, documentez la conservation et fournissez un plan de suppression des données sur demande

Checklist par rôle

• Administrateur système

  • Installer et sécuriser Apache/MariaDB, gérer certificats TLS
  • Sauvegardes et restauration
  • Surveillance des logs

• Responsable projet

  • Créer projets et rôles
  • Définir workflows et trackers

• Développeur / intégrateur

  • Connecter VCS (Git/SVN)
  • Gérer hooks et intégrations CI

• Utilisateur final

  • Se connecter, mettre à jour son profil, créer tickets

Critères d’acceptation

• L’URL http://votre-domaine/ renvoie la page d’accueil Redmine
• Connexion réussie avec le compte admin et mot de passe changé
• Les pages du projet et le wiki s’affichent sans erreur 500
• Les sauvegardes peuvent être restaurées sans perte de données

Astuces et alternatives

• Alternative : installer Redmine via rbenv/ruby et bundler pour contrôler la version Ruby et des gems (recommandé en production).
• Hébergement conteneurisé : utiliser Docker / docker-compose pour isoler dépendances et faciliter migration.
• Si vous avez besoin d’authentification centralisée, configurez LDAP/Active Directory dans l’administration Redmine.

Commandes utiles (cheat sheet)

• Démarrer/arrêter Apache : sudo systemctl restart apache2
• Vérifier journal Apache : sudo tail -f /var/log/apache2/error.log
• Vérifier état MariaDB : sudo systemctl status mariadb

Mini méthodologie de mise en production

1. Installer dans un environnement de staging identique à la production
2. Tester import/export des projets et permissions
3. Mettre en place sauvegardes automatiques et monitorer les performances
4. Valider la montée en charge et le plan de restauration

Résumé

Redmine peut être déployé rapidement sur Ubuntu 18.04 à l’aide des paquets officiels, Apache et MariaDB. Les étapes clés sont : installer les dépendances, sécuriser MariaDB, installer Redmine, configurer Apache/Passenger, vérifier les permissions et changer le mot de passe admin. En production, préférez HTTPS, sauvegardes régulières et, si besoin, une installation depuis les sources pour un contrôle fin.

Principales actions à retenir : installez les paquets, sécurisez la base, créez le lien symbolique, configurez Apache, redémarrez, changez le mot de passe admin et activez HTTPS.