Installation GLPI sur Debian 12 : tutoriel LAMP pas à pas

Installation du serveur LAMP (Apache, MariaDB, PHP) sur Debian 12

GLPI repose sur une pile LAMP : Linux, Apache, MariaDB et PHP. Sur Debian 12, la distribution fournit nativement PHP 8.2, la version recommandée pour faire tourner GLPI dans de bonnes conditions. Une VM de test répondant à 1 Go de mémoire vive et 8 Go de stockage suffit largement pour valider l’installation avant de passer en production.

Installation des paquets Apache, MariaDB et PHP 8.2

• Mise à jour du système : lancer apt update puis apt upgrade avant tout.
• Serveur web : installer le paquet apache2 via apt.
• Base de données : installer mariadb-server pour héberger les tables GLPI.
• Interpréteur PHP : installer php8.2 avec les extensions mysqli, gd, curl, xml et mbstring.
• Modules Apache : activer rewrite et headers avec a2enmod.

Vérification des modules PHP dans Apache et correctifs post-migration

Après l’installation, contrôlez que le module PHP 8.2 est bien chargé par Apache en inspectant le contenu de /etc/apache2 et les fichiers de conf disponibles. Un redémarrage du service apache2 valide la prise en compte.

Si vous migrez depuis Debian 11, le piège classique reste le paquet php8.2-mysql absent : sans lui, GLPI ne peut pas dialoguer avec MariaDB. Pensez à installer explicitement cette extension, car l’ancienne PHP 7.4 n’est plus supportée.

Création de la base MariaDB et de l’utilisateur dédié GLPI

• Connexion : ouvrir une session mysql en root.
• Base dédiée : créer une base nommée glpi avec un jeu de caractères utf8mb4.
• Utilisateur spécifique : créer un compte MySQL réservé à GLPI.
• Privilèges : accorder tous les droits sur la base glpi à cet utilisateur.
• Sécurisation : exécuter mysql_secure_installation pour durcir l’accès au serveur.

Téléchargement et déploiement de l’archive GLPI 10.0.6

• Archive : récupérer la version stable GLPI 10.0.6 depuis le dépôt officiel.
• Décompression : extraire l’archive dans /var/www/html.
• Renommage : renommer le dossier obtenu en glpi.
• Droits : attribuer la propriété à www-data sur /var/www/html/glpi.
• Apache : redémarrer le service pour appliquer la configuration.

Notez que la version 10.0.7 constitue le minimum requis pour un support complet de PHP 8, et que le futur GLPI 11 accompagnera le passage à Debian 13.

Mise à jour et préparation du système Debian 12

Avant de toucher à Apache, MariaDB ou PHP, prenez le réflexe de mettre à jour votre système Debian 12. Cette étape évite les conflits de dépendances lors de l’installation du serveur LAMP et corrige les failles de sécurité connues.

• Mettre à jour les paquets Debian : lancez apt update puis apt upgrade avant toute installation.
• Redémarrer si le noyau change : un reboot est nécessaire pour charger la nouvelle version.
• VM 1 Go RAM minimum : configuration testée pour faire tourner GLPI sans swap excessif.
• Disque 8 Go minimum : espace suffisant pour le système, la base et l’archive GLPI décompressée.
• Snapshot VM avant upgrade : indispensable pour restaurer l’état initial en cas d’échec.

Une machine virtuelle Debian 12 configurée avec 1 Go de mémoire vive et 8 Go de stockage suffit largement pour un GLPI en production légère. Inutile de prévoir une interface graphique, un serveur en ligne de commande reste plus léger et plus sûr.

Si vous migrez depuis une version antérieure de Debian, sachez que le passage de Debian 11 vers Debian 12 fait sauter PHP de la branche 7.4 (support terminé) à la branche 8.2. Ce changement de version majeure est la première cause de casse après migration.

Finalisation de l’installation via l’interface web GLPI

Accès à l’assistant web et connexion à la base

Une fois l’archive déployée dans /var/www/html/glpi, ouvrez votre navigateur et rendez-vous sur http://IP_SERVEUR/glpi. L’assistant d’installation s’affiche automatiquement si la configuration locale est correcte. Choisissez la langue, puis cliquez sur « Installer » pour lancer la procédure guidée.

Renseignez ensuite les paramètres MariaDB : serveur localhost, nom de la base glpi, ainsi que l’utilisateur MySQL dédié créé précédemment. GLPI teste la connexion avant d’écrire les tables. Validez, puis notez les identifiants par défaut (glpi/glpi, tech/tech, admin/admin) et modifiez-les immédiatement après la première connexion.

Résolution de la page blanche et erreurs d’upgrade

La page blanche est l’erreur la plus fréquente après la finalisation ou lors d’un upgrade. Elle signale presque toujours un problème de droits, une extension PHP manquante ou une version GLPI incohérente. Avant toute chose, attribuez les bons droits au dossier :

• Droits www-data : chown -R www-data:www-data /var/www/html/glpi
• Extensions PHP : vérifier mysql, xml, mbstring, curl et gd actives
• Cache navigateur : vider le cache puis recharger avec Ctrl+F5
• Logs Apache : consulter /var/log/apache2/error.log pour la cause exacte
• Version 10.0.7 : minimum requis pour un support stable de PHP 8

Après chaque modification, redémarrez Apache avec systemctl restart apache2. Si la page blanche persiste malgré des droits corrects et des extensions présentes, vérifiez que votre version GLPI est bien 10.0.7 ou supérieure : la branche 10.0.6 reste fonctionnelle mais peut poser des soucis sur certaines configurations PHP 8.2.

Téléchargement et décompression de l’archive GLPI

Choix de la version GLPI 10.0.6 et compatibilité PHP 8

Décompression et placement dans le répertoire web

Rendez-vous sur le site officiel de GLPI et récupérez l’archive glpi-10.0.6.tgz proposée dans la section des versions stables. Cette version 10.0.6 sert de référence dans ce guide car elle couvre les besoins courants d’un parc informatique tout en restant légère à déployer.

Placez ensuite l’archive dans /tmp ou dans votre répertoire personnel, puis décompressez-la avec la commande tar xvf glpi-10.0.6.tgz. Le dossier extrait porte simplement le nom GLPI. Déplacez-le vers /var/www/html/glpi pour qu’Apache puisse le servir.

Attribuez les bons droits au répertoire avec chown -R www-data:www-data /var/www/html/glpi, puis relancez systemctl restart apache2. Sans cette étape, la page d’accueil restera inaccessible ou renverra une erreur 403 Forbidden. Une fois ces commandes exécutées, l’assistant web est prêt à être lancé depuis votre navigateur.

FAQ installation GLPI Debian 12

Quels prérequis système pour GLPI sur Debian 12

GLPI 10 exige Debian 12, Apache 2.4, MariaDB 10.5 minimum, PHP 8.1 ou 8.2 avec les extensions mysqli, gd, curl, xml, mbstring, intl et zip. Comptez 2 Go de RAM et 10 Go d’espace disque.

Comment procéder à la migration de Debian 11 vers Debian 12

Passez par la commande apt full-upgrade après avoir mis à jour les sources vers bookworm. Sauvegardez la base GLPI, les fichiers de configuration et le dossier files avant de lancer la migration.

Pourquoi une page blanche apparaît après installation

Une page blanche vient d’une erreur PHP masquée ou d’une extension manquante. Activez display_errors dans php.ini, consultez les logs Apache et vérifiez les droits sur les dossiers files et config.

Quelle version GLPI choisir avec PHP 8.2

GLPI 10.0.6 ou supérieur est recommandé avec PHP 8.2. Les versions antérieures à la 10.0 génèrent des avertissements de dépréciation et des bugs avec PHP 8.2 sur Debian 12.

Comment sécuriser la base MariaDB de GLPI

Créez un utilisateur dédié avec des privilèges limités à la base GLPI, utilisez un mot de passe long, restreignez l’accès à localhost et lancez mysql_secure_installation pour durcir MariaDB.

Faut-il configurer Redis pour GLPI sur Debian 12

Redis reste optionnel pour une petite instance GLPI. Il devient utile dès que plusieurs utilisateurs sont simultanés, car il gère le cache et les sessions plus efficacement que le système de fichiers.

Comment connecter GLPI après l’assistant web

Connectez-vous avec le compte glpi et le mot de passe glpi créés par défaut, puis changez immédiatement ces identifiants dans Configuration, Utilisateurs. Supprimez aussi le dossier install.

Que faire en cas de perte d’accès après upgrade

Restaurez la base et le fichier config_db.php depuis la sauvegarde. Si le compte admin est perdu, réinitialisez le mot de passe via une requête SQL directe dans la table glpi_users.