Introduction

Redmine est un outil de gestion de projet open-source puissant et flexible qui permet le suivi des problèmes, le suivi du temps, la fonctionnalité wiki et l’intégration du contrôle de version. Il est construit sur Ruby on Rails et supporte plusieurs bases de données, dont MySQL et PostgreSQL. Dans ce guide, nous allons suivre pas à pas le processus d’installation de Redmine sur Ubuntu 22.04.

Prérequis

Avant de commencer, assurez-vous que votre système répond aux exigences suivantes :

  • Une installation récente d’Ubuntu 22.04
  • Un utilisateur non-root avec les privilèges sudo
  • Une connexion internet fonctionnelle
  • Un nom de domaine (facultatif mais recommandé)

Étape 1 : Mise à jour des paquets système

Tout d’abord, mettez à jour la liste des paquets et mettez à niveau les paquets existants pour vous assurer que votre système est à jour :

sudo apt update && sudo apt upgrade -y

Étape 2 : Installer les dépendances requises

Redmine nécessite plusieurs dépendances, notamment Ruby, Bundler et un serveur de base de données. Nous allons d’abord installer ces paquets.

sudo apt install -y curl gnupg2 git-core libmysqlclient-dev imagemagick libmagickwand-dev libpq-dev build-essential libssl-dev libreadline-dev zlib1g-dev

Étape 3 : Installer Ruby

Ubuntu 22.04 n’inclut pas la dernière version de Ruby par défaut, nous allons donc installer Ruby en utilisant rbenv.

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
cd ~/.rbenv && src/configure && make -C src
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Installez maintenant Ruby :

rbenv install 3.2.0 # Utilise la dernière version stable
rbenv global 3.2.0
ruby -v # Vérifier l'installation

Étape 4 : Installer le serveur de base de données

Redmine supporte MySQL et PostgreSQL. Dans ce guide, nous utiliserons MySQL.

sudo apt install -y mysql-server

Sécurisez l’installation de MySQL :

sudo mysql_secure_installation

Créez une base de données et un utilisateur Redmine :

sudo mysql -u root -p

Dans le shell MySQL, exécutez les commandes suivantes :

CREATE DATABASE redmine CHARACTER SET utf8mb4 ;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'strongpassword' ;
ACCORDER TOUS LES PRIVILEGES SUR redmine.* A 'redmine'@'localhost' ;
EFFACE LES PRIVILÈGES ;
EXIT ;

Etape 5 : Installer Redmine

Téléchargez et extrayez la dernière version stable de Redmine :

cd /var/www/
wget https://www.redmine.org/releases/redmine-5.0.0.tar.gz
sudo tar -xvf redmine-5.0.0.tar.gz
sudo mv redmine-5.0.0 redmine
cd redmine

Configurez la connexion à la base de données :

cp config/database.yml.example config/database.yml
nano config/database.yml

Modifiez la section MySQL comme suit :

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "strongpassword"
  encoding: utf8mb4

Étape 6 : Installer Bundler et ses dépendances

Exécutez les commandes suivantes pour installer Bundler et les gems nécessaires :

gem install bundler
bundle install --without development test

Étape 7 : Configurer la base de données

Exécutez les commandes suivantes pour initialiser la base de données :

bundle exec rake db:migrate RAILS_ENV=production
bundle exec rake redmine:load_default_data RAILS_ENV=production

Etape 8 : Configurer les permissions sur les fichiers

Assurez-vous que Redmine a les bonnes permissions :

sudo mkdir -p tmp tmp/pdf public/plugin_assets
sudo chown -R www-data:www-data files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets

Etape 9 : Démarrer Redmine

Vous pouvez démarrer Redmine en utilisant le serveur WEBrick intégré :

bundle exec rails server -e production

Vous pouvez également configurer Redmine pour qu’il fonctionne avec Passenger et Apache ou Nginx pour une utilisation en production.

Etape 10 : Accéder à Redmine

Ouvrez votre navigateur web et naviguez vers :

http://your-server-ip:3000

Connectez-vous avec les informations d’identification par défaut :

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

Conclusion

Vous avez installé avec succès Redmine sur Ubuntu 22.04. Pour les environnements de production, pensez à mettre en place un proxy inverse avec Nginx ou Apache, à activer SSL, et à configurer des sauvegardes automatiques. Redmine est maintenant prêt à gérer efficacement vos projets !