Installer et Configurer GLPI 12
1. Présentation et prérequis
Architecture
Élément
Choix
Système
Debian 13 « Trixie »
Serveur web
Apache 2.4 avec PHP-FPM
Base de données
MariaDB
Application
GLPI 12.0.0
Usage E6
Gestion des incidents et gestion des configurations
GLPI 12 exige PHP 8.3 ou plus récent. Debian 11 et 12 n'ont que PHP 7.4 et 8.2, donc elles ne conviennent pas. Si votre sandbox impose Debian 11, utilisez GLPI 10, ou une VM Debian 13.
Un retour d'installation de GLPI 12.0.0 sur Debian 13 mentionne PHP 8.4, Apache 2.4 et MariaDB 11.8. La version 12.0.1 corrige des failles de sécurité ; remplacez
VERSION dans les commandes pour l'utiliser.
Matériel conseillé pour la VM
2 vCPU, 4 Go de RAM, 30 Go de disque.
Une adresse IP fixe.
Un accès internet pendant l'installation.
2. Préparer le système
sudo apt update && sudo apt upgrade -y
sudo hostnamectl set-hostname glpi
sudo timedatectl set-timezone Europe/Paris
cat /etc/os-release
Installez les paquets. Les extensions obligatoires pour GLPI 11 et plus incluent
curl,
gd,
intl,
mysqli,
bcmath,
mbstring et
openssl.
ldap sert à l'authentification Active Directory,
zip et
bz2 au marketplace.
sudo apt install -y apache2 mariadb-server wget tar \
php php-cli php-fpm libapache2-mod-fcgid \
php-curl php-gd php-intl php-mysql php-xml php-mbstring \
php-bcmath php-zip php-bz2 php-ldap php-opcache php-apcu
php -v
La version affichée doit être 8.3 ou supérieure.
3. Installer et sécuriser MariaDB
sudo systemctl enable --now mariadb
sudo mysql_secure_installation
Créez la base et l'utilisateur, après avoir remplacé
MOT_DE_PASSE_GLPI :
sudo mysql
CREATE DATABASE glpi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'glpi'@'localhost' IDENTIFIED BY 'MOT_DE_PASSE_GLPI';
GRANT ALL PRIVILEGES ON glpi.* TO 'glpi'@'localhost';
GRANT SELECT ON mysql.time_zone_name TO 'glpi'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Chargez les fuseaux horaires :
mariadb-tzinfo-to-sql /usr/share/zoneinfo | sudo mysql mysql
Vérifiez la connexion avec le mot de passe défini :
mysql -u glpi -p glpi -e "SELECT 1;"
4. Télécharger GLPI
Utilisez l'archive
glpi-VERSION.tgz des releases, pas les archives « Source code » de GitHub.
cd /tmp
VERSION=12.0.0
wget https://github.com/glpi-project/glpi/releases/download/${VERSION}/glpi-${VERSION}.tgz
sudo tar -xzf glpi-${VERSION}.tgz -C /var/www/
ls /var/www/glpi
5. Séparer code, configuration et données
La documentation recommande de placer la configuration, les fichiers de données et les journaux hors du code, selon la norme FHS.
sudo mkdir -p /etc/glpi /var/lib/glpi /var/log/glpi
sudo cp -a /var/www/glpi/config /etc/glpi/
sudo cp -a /var/www/glpi/files /var/lib/glpi/
Créez
/var/www/glpi/inc/downstream.php :
ServerName glpi.local
DocumentRoot /var/www/glpi/public
Require all granted
RewriteEngine On
RewriteCond %{HTTP:Authorization} ^(.+)$
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php [QSA,L]
SetHandler "proxy:unix:/run/php/php-fpm.sock|fcgi://localhost"
Si
php-fpm.sock n'apparaît pas dans
/run/php/, utilisez le nom réel du socket, par exemple
php8.4-fpm.sock.
Activez les modules et le site :
sudo a2enmod rewrite proxy_fcgi setenvif
sudo a2dissite 000-default
sudo a2ensite glpi
sudo apache2ctl configtest
Sécurisez les sessions PHP dans le
php.ini de PHP-FPM, en remplaçant
8.4 par votre version :
sudo nano /etc/php/8.4/fpm/php.ini
session.cookie_httponly = On
session.cookie_samesite = Lax
; session.cookie_secure = On (uniquement après l'activation du HTTPS)
sudo systemctl restart php8.4-fpm apache2
sudo systemctl enable php8.4-fpm apache2
7. Terminer l'installation
Par l'assistant web
Ouvrez
http://IP_DU_SERVEUR/, puis :
Choisissez la langue et acceptez la licence.
Cliquez sur Installer et corrigez tout prérequis en rouge.
Renseignez la base : serveur
localhost, utilisateur
glpi, mot de passe
MOT_DE_PASSE_GLPI.
Sélectionnez la base
glpi.
Terminez l'installation.
Par la ligne de commande
cd /var/www/glpi
sudo -u www-data php bin/console db:install \
--db-host=localhost --db-name=glpi \
--db-user=glpi --db-password='MOT_DE_PASSE_GLPI' \
--default-language=fr_FR
8. Comptes par défaut
L'installation crée quatre comptes :
glpi/glpi administrateur,
tech/tech technicien,
normal/normal utilisateur normal et
post-only/postonly utilisateur limité aux tickets.
Après la première connexion :
Créez un nouvel utilisateur avec le profil
super-admin.
Changez le mot de passe de
glpi, ou désactivez ce compte.
Supprimez ou désactivez
tech,
normal et
post-only, ou changez leurs mots de passe.
Ne touchez pas à
glpi-system, utilisé par les fonctions automatiques.
Supprimez aussi le script d'installation s'il est resté présent :
sudo rm -f /var/www/glpi/install/install.php
9. Tâches planifiées et HTTPS
sudo crontab -u www-data -e
* * * * * /usr/bin/php /var/www/glpi/front/cron.php &>/dev/null
Pour une sandbox, créez un certificat auto-signé :
sudo a2enmod ssl headers
sudo mkdir -p /etc/ssl/glpi
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
-keyout /etc/ssl/glpi/glpi.key -out /etc/ssl/glpi/glpi.crt \
-subj "/CN=glpi.local"
Ajoutez un second
VirtualHost *:443 qui reprend la configuration précédente avec :
SSLEngine on
SSLCertificateFile /etc/ssl/glpi/glpi.crt
SSLCertificateKeyFile /etc/ssl/glpi/glpi.key
Redirigez ensuite le port 80 vers le HTTPS, puis activez
session.cookie_secure = On et redémarrez PHP-FPM et Apache.
10. Configuration pour l'E6
Organisation
Créez les entités, les profils, les groupes de techniciens et quelques utilisateurs de test.
Configurez les catégories de tickets et les délais de prise en charge.
Authentification Active Directory
Dans la liste de votre épreuve, l'annuaire est un Active Directory sous Windows Server 2019.
Allez dans Configuration > Authentification > Annuaire LDAP.
Renseignez le serveur AD, le DN de base et un compte de lecture dédié.
Testez la connexion, puis importez des utilisateurs.
Inventaire et gestion des configurations
Activez l'inventaire natif dans Administration > Inventaire.
Installez l'agent GLPI sur un poste Windows et un serveur Linux.
Vérifiez que les machines apparaissent dans le parc.
Documentez les logiciels, versions et propriétaires.
Gestion des incidents
Configurez l'e-mail sortant pour les notifications.
Créez un ticket de test, assignez-le, résolvez-le, puis documentez la solution.
Associez le ticket à un équipement de l'inventaire.
Lien avec Zabbix
Simulez un service arrêté sur une machine supervisée : Zabbix déclenche l'alerte, vous ouvrez le ticket dans GLPI, puis vous le résolvez. Cela montre la supervision, l'incident et la configuration avec deux outils.
11. Sauvegarde
sudo mkdir -p /root/backups-glpi
sudo mysqldump --single-transaction --routines --triggers glpi \
> "/root/backups-glpi/glpi-$(date +%F).sql"
sudo tar -czf "/root/backups-glpi/glpi-files-$(date +%F).tar.gz" \
/etc/glpi /var/lib/glpi /var/www/glpi/marketplace
Si vous utilisez PBS, sauvegardez la VM entière sur un stockage séparé de l'hôte Proxmox, puis testez une restauration.
12. Validation et dépannage
Vérification
Commande ou action
Services actifs
systemctl is-active apache2 mariadb php8.4-fpm
Syntaxe Apache
sudo apache2ctl configtest
Journal Apache
sudo tail -f /var/log/apache2/error.log
Journal GLPI
sudo tail -f /var/log/glpi/php-errors.log
Cron GLPI
Page Configuration > Actions automatiques
Symptôme
Piste
Page Apache par défaut
a2ensite glpi et
a2dissite 000-default
Erreur 500
Journal Apache, extension PHP manquante ou droits
Prérequis rouges
Installez le paquet
php-... correspondant
Erreur d'écriture
Propriétaire
www-data sur
/etc/glpi,
/var/lib/glpi,
/var/log/glpi
Fuseaux horaires
Relancez
mariadb-tzinfo-to-sql et le
GRANT SELECT