Installer OrangeHRM Open Source sur un serveur demande de préparer correctement l’environnement web, la base de données et les droits d’accès avant de lancer l’assistant d’installation. La procédure peut être réalisée sur un serveur Linux équipé d’une pile LAMP ou sur Windows avec XAMPP. Une fois les fichiers en place et la base MySQL créée, l’installation se déroule principalement depuis le navigateur.
🖥️ Préparer le serveur avant l’installation d’OrangeHRM
La première étape consiste à vérifier que le serveur dispose des composants nécessaires à OrangeHRM. L’application fonctionne avec un serveur web Apache, PHP et une base de données MySQL ou MariaDB. Les versions exactes à utiliser peuvent varier selon la version d’OrangeHRM téléchargée.
| Composant | Configuration indiquée |
| 🌐 Serveur web | Apache 2.2 ou supérieur, Apache 2.4+ recommandé |
| 🐘 PHP | PHP 7.4 ou version supérieure selon la version d’OrangeHRM |
| 🗄️ Base de données | MySQL 5.5+ ou MariaDB 5.5+ |
| 🔧 Extensions PHP | mbstring, curl, json, mysql et extensions requises par la version installée |
| 🖥️ Environnement | Linux/LAMP ou Windows/XAMPP |
Avant de poursuivre, il est préférable de vérifier la compatibilité entre la version d’OrangeHRM et celle de PHP. Une version de PHP trop récente ou trop ancienne peut empêcher l’installateur de démarrer correctement ou provoquer des erreurs pendant la configuration.
🔍 Vérifier les extensions PHP nécessaires
OrangeHRM dépend de plusieurs extensions PHP. Sur un serveur Linux, leur présence peut être contrôlée avec les outils du système ou depuis la configuration PHP. Avec XAMPP, la configuration peut être vérifiée dans le fichier php.ini.
Les extensions manquantes sont généralement signalées lorsque l’assistant OrangeHRM effectue son contrôle préalable. Il est donc préférable de corriger ces éléments avant de poursuivre l’installation.
📦 Placer OrangeHRM dans le répertoire du serveur web
Une fois l’environnement prêt, téléchargez l’archive OrangeHRM Open Source correspondant à la version souhaitée. Le fichier est généralement fourni sous forme d’archive ZIP qu’il faut extraire avant de pouvoir lancer l’installation.
Sur un serveur Linux utilisant Apache, le répertoire peut par exemple être :
/var/www/html/
Avec XAMPP sous Windows, les fichiers peuvent être placés dans :
C:\xampp\htdocs\
Il est possible de conserver le nom du dossier fourni dans l’archive ou de le renommer, par exemple :
/var/www/html/orangehrm
Le serveur web doit ensuite pouvoir accéder à l’ensemble des fichiers. Sur Linux, les permissions du répertoire méritent une attention particulière, car Apache doit pouvoir lire les fichiers nécessaires et écrire dans les emplacements prévus par OrangeHRM.
🌐 Tester l’accès aux fichiers depuis le navigateur
Après avoir placé les fichiers, vérifiez que le serveur web répond correctement. Pour une installation locale avec XAMPP, l’adresse peut être :
http://localhost/orangehrm
Sur un serveur distant :
http://votre_ip_serveur/orangehrm
Si la page d’installation ne s’affiche pas, il faut vérifier Apache, le chemin du dossier, les permissions et la configuration PHP avant de passer à la suite.
🗄️ Créer une base MySQL dédiée à OrangeHRM
OrangeHRM doit disposer d’une base de données pour enregistrer les informations de l’application. Cette base peut être créée avec phpMyAdmin, le client MySQL ou MariaDB en ligne de commande.
Un nom comme orangehrm_db peut être utilisé pour identifier facilement la base.
La configuration doit également prévoir un utilisateur MySQL dédié disposant des droits nécessaires sur cette base. Cette approche est généralement préférable à l’utilisation permanente du compte root, notamment sur un serveur accessible depuis Internet.
| Paramètre | Exemple |
| 🗄️ Base | orangehrm_db |
| 🖥️ Hôte | localhost |
| 👤 Utilisateur | orangehrm_user |
| 🔐 Mot de passe | Mot de passe fort et unique |
Avec phpMyAdmin, la création peut être réalisée depuis l’interface de gestion des bases. En ligne de commande, la base et le compte peuvent également être créés directement dans MySQL ou MariaDB.
🔐 Attribuer les droits à l’utilisateur MySQL
L’utilisateur destiné à OrangeHRM doit disposer des permissions nécessaires sur la base créée. Il faut notamment pouvoir créer et modifier les tables utilisées par l’application pendant l’installation.
Une fois cette configuration terminée, conservez soigneusement le nom de la base, l’identifiant et le mot de passe : ces informations seront demandées par l’assistant web.
🚀 Lancer l’assistant d’installation OrangeHRM
Lorsque Apache, PHP, les extensions et MySQL sont prêts, ouvrez l’adresse correspondant au dossier OrangeHRM dans votre navigateur.
Par exemple :
http://localhost/orangehrm
ou :
http://votre_ip_serveur/orangehrm
L’assistant d’installation prend alors le relais.
📜 Accepter la licence OrangeHRM
La première partie de l’assistant présente les informations relatives à la licence. OrangeHRM Open Source étant distribué sous GNU GPL, il faut accepter les conditions affichées avant de continuer.
Cliquez ensuite sur Suivant pour accéder au contrôle de l’environnement.
🟢 Corriger les éventuels problèmes détectés par l’assistant
L’installateur effectue plusieurs vérifications concernant l’environnement serveur. Il contrôle notamment la version de PHP, certaines extensions et les permissions nécessaires au fonctionnement de l’application.
Les éléments conformes apparaissent généralement comme validés. Si un contrôle échoue, mieux vaut corriger le problème avant de continuer plutôt que de poursuivre avec une configuration incomplète.
Les erreurs de permissions sont particulièrement à surveiller sur Linux. Une extension PHP absente peut également empêcher certaines parties d’OrangeHRM de fonctionner correctement.
🔗 Renseigner les paramètres de connexion MySQL
L’étape suivante demande les informations de la base de données créée précédemment.
Il faut généralement renseigner :
- Nom de l’hôte : localhost dans une installation classique ;
- Nom de la base : par exemple orangehrm_db ;
- Nom d’utilisateur : le compte MySQL créé pour OrangeHRM ;
- Mot de passe : celui associé à ce compte.
L’assistant teste ensuite la connexion à la base. Si les informations sont correctes et que MySQL ou MariaDB est accessible, l’installation peut continuer.
⚠️ Une erreur de connexion pointe souvent vers la configuration MySQL
Un message d’erreur à cette étape ne signifie pas nécessairement qu’OrangeHRM est mal installé. Il peut provenir d’un mauvais identifiant, d’un mot de passe incorrect, d’un nom de base inexistant ou d’un serveur MySQL qui n’est pas démarré.
Sur une installation XAMPP, vérifiez notamment que MySQL est bien lancé dans le panneau de contrôle XAMPP. Sur Linux, le service MariaDB ou MySQL doit également être actif.
A lire aussi: Par chance facture : gratuit, mais compliqué à utiliser !
👤 Créer le compte administrateur principal
Après la connexion à la base de données, l’assistant demande les informations nécessaires pour créer le premier compte administrateur.
Choisissez un nom d’utilisateur identifiable et surtout un mot de passe suffisamment robuste. Ce compte permettra d’accéder à l’administration d’OrangeHRM une fois l’installation terminée.
Il est préférable d’éviter les identifiants trop prévisibles et de conserver les informations d’accès dans un gestionnaire de mots de passe.
✅ Vérifier la configuration avant de lancer l’installation
Avant la création définitive de l’environnement OrangeHRM, l’assistant affiche un récapitulatif des paramètres renseignés.
Prenez le temps de contrôler :
- 🗄️ le nom de la base ;
- 🖥️ l’hôte MySQL ;
- 👤 le compte utilisé pour la connexion ;
- 🔐 le mot de passe de la base ;
- 👨💼 les informations du compte administrateur ;
- ⚙️ les paramètres détectés par l’assistant.
Si toutes les informations sont correctes, validez le lancement de l’installation.
OrangeHRM va alors créer les éléments nécessaires dans la base de données et mettre en place la configuration de l’application.
🔒 Sécuriser l’installation après la création d’OrangeHRM
L’installation ne doit pas être considérée comme terminée dès que l’écran de connexion apparaît. Une vérification de sécurité doit être effectuée immédiatement après la création de l’application.
Si l’installateur demande de supprimer ou protéger certains fichiers ou répertoires d’installation, cette opération doit être réalisée. L’objectif est d’empêcher qu’un tiers puisse relancer ou manipuler l’assistant d’installation depuis le serveur.
Il faut également vérifier les permissions des fichiers et éviter de laisser des droits d’écriture trop larges sur l’ensemble du répertoire OrangeHRM.
🔐 Utiliser HTTPS sur un serveur accessible depuis Internet
Pour une installation destinée à une entreprise, l’accès à OrangeHRM doit être protégé par HTTPS. L’interface peut contenir des informations relatives aux salariés, aux comptes utilisateurs et à l’organisation interne.
Le serveur Apache doit donc être configuré avec un certificat TLS valide avant de mettre l’application à disposition des utilisateurs.
🎯 Se connecter à OrangeHRM après l’installation
Lorsque l’installation est terminée, retournez sur l’adresse de l’application :
http://localhost/orangehrm
ou sur l’adresse correspondant à votre serveur.
La page de connexion permet d’utiliser le compte administrateur créé pendant l’installation. Après connexion, vérifiez que l’interface s’affiche correctement et que les principaux modules sont accessibles.
Il est ensuite possible de poursuivre la configuration d’OrangeHRM : création des utilisateurs, organisation des employés, paramètres de l’entreprise et gestion des droits selon les besoins de l’installation.
🧰 Les principaux contrôles à effectuer après la première connexion
| Contrôle | À vérifier |
| 🟢 Connexion | Le compte administrateur fonctionne |
| 🗄️ Base de données | OrangeHRM communique correctement avec MySQL/MariaDB |
| 🔒 Sécurité | Les fichiers d’installation ne sont plus exposés |
| 🌐 HTTPS | Le serveur utilise un certificat TLS |
| 👥 Utilisateurs | Les comptes et permissions peuvent être configurés |
| ⚙️ Application | Les modules nécessaires sont accessibles |