1. Introduction

L’installation de Dolibarr ERP CRM sur un environnement local Mac via MAMP est une pratique courante chez les développeurs, intégrateurs et entreprises souhaitant tester ou déployer une solution ERP en local. Cependant, malgré la simplicité apparente du processus, de nombreux utilisateurs rencontrent des difficultés techniques lors de l’installation, comme cela a été discuté dans le forum Dolibarr.
Ce type de problème est fréquent, notamment chez les utilisateurs débutants ou ceux qui ne maîtrisent pas parfaitement l’environnement Apache, MySQL et PHP. Cet article analyse en détail les problèmes rencontrés, les causes techniques et les solutions proposées, tout en ajoutant des recommandations avancées pour garantir une installation réussie en 2026.

2. Contexte technique de l’installation Dolibarr sur Mac

Avant d’aborder les problèmes, il est essentiel de comprendre l’environnement technique.
Dolibarr nécessite :

• Un serveur web (Apache)
• Un serveur de base de données (MySQL ou MariaDB)
• PHP
  Sur Mac, l’outil le plus utilisé pour simuler cet environnement est MAMP.

Le principe est simple :

• Installer MAMP
• Copier Dolibarr dans le dossier serveur
• Lancer l’installation via navigateur

Cependant, plusieurs erreurs peuvent survenir à différentes étapes.

3. Problème principal rencontré dans le forum

Le problème typique remonté par les utilisateurs est le suivant :

➡️ Après installation de MAMP et placement de Dolibarr dans le dossier, l’utilisateur accède à :
http://localhost:8888/

Mais au lieu de voir l’installateur Dolibarr, il voit la page par défaut de MAMP.

Ce problème est critique car il empêche totalement le lancement de Dolibarr.

4. Analyse technique du problème

Ce comportement est généralement lié à un problème de configuration du “Document Root” (répertoire racine du serveur web).

Par défaut, MAMP pointe vers :
/Applications/MAMP/htdocs

Donc même si Dolibarr est installé ailleurs, Apache ne le “voit pas”.

Selon la documentation officielle, il est nécessaire de configurer correctement ce chemin

5. Solution 1 : Configurer correctement le Document Root

C’est la solution principale proposée et validée.

Étapes :

1. Ouvrir MAMP
2. Aller dans Preferences
3. Aller dans Web Server
4. Modifier le Document Root
5. Pointer vers :
   /Applications/MAMP/dolibarr/htdocs

Une fois cette modification effectuée :

• Redémarrer les serveurs
• Recharger localhost

???? Résultat : Dolibarr devient accessible

6. Solution 2 : Placer Dolibarr directement dans htdocs

Alternative simple :

Au lieu de modifier MAMP, il est possible de déplacer Dolibarr dans :
/Applications/MAMP/htdocs/dolibarr

Puis accéder à :
http://localhost:8888/dolibarr/htdocs

Cette solution est souvent plus simple pour les débutants.

7. Problème lié à la base de données

Un autre problème fréquent concerne la configuration MySQL.

Erreurs typiques :

• Impossible de créer la base
• Accès refusé
• Mauvais identifiants

Solution standard :

• Utiliser :
  • User : root
  • Password : root
• Activer “Créer la base”

Selon la documentation officielle, ces identifiants sont ceux par défaut dans MAMP

8. Problème de port Apache

Certains utilisateurs oublient que MAMP utilise le port 8888 par défaut.

Donc :

• ❌ http://localhost → ne fonctionne pas
• ✔ http://localhost:8888 → fonctionne

Ce détail est souvent la cause d’échec d’installation.

9. Problème de configuration PHP

Dolibarr nécessite une version compatible de PHP.

Problèmes possibles :

• Version PHP trop ancienne
• Extensions manquantes

Solution :

• Vérifier dans MAMP :
  • PHP ≥ 7.2 recommandé
• Activer extensions :
  • mysqli
  • gd
  • curl

10. Problème de droits fichiers (permissions)

Un problème moins évident mais fréquent :

➡️ Dolibarr ne peut pas écrire dans certains dossiers

Solution :

• Vérifier permissions du dossier
• Donner accès en écriture

Exemple :

• documents
• htdocs/conf

11. Problème de sécurité après installation

Dolibarr affiche souvent des alertes après installation :

• absence du fichier install.lock
• fichier config modifiable

Solution officielle :

• créer install.lock
• passer conf.php en lecture seule

12. Problème lié à l’évolution Mac

Un point important en 2026 :

Les anciennes solutions comme DoliMamp ne sont plus maintenues.

➡️ Les utilisateurs doivent installer manuellement Dolibarr

Comme indiqué dans la documentation :

• l’auto-installateur Mac n’est plus fourni

13. Solutions alternatives recommandées

Pour éviter les problèmes MAMP, plusieurs alternatives existent :

Option 1 : Docker

• installation rapide
• environnement isolé

Option 2 : Bitnami

• installation simplifiée

Option 3 : hébergement cloud

• pas de configuration locale

14. Bonnes pratiques pour une installation réussie

Pour éviter tous ces problèmes :

1. Installer MAMP proprement
2. Vérifier les ports
3. Configurer Document Root
4. Vérifier PHP
5. Créer base de données
6. Sécuriser installation

Ces étapes garantissent un fonctionnement optimal.

15. Impact pour les entreprises et intégrateurs

Une mauvaise installation peut entraîner :

• perte de temps
• erreurs techniques
• mauvaise première expérience

À l’inverse, une installation réussie permet :

• tests rapides
• formation des équipes
• développement de modules

16. Vision SEO et stratégique

Le sujet “Dolibarr MAMP Mac” est très recherché car :

• forte communauté
• problème récurrent
• manque de guides complets

???? C’est donc un excellent sujet SEO pour attirer du trafic qualifié.

17. Conclusion

L’installation de Dolibarr sur Mac avec MAMP peut sembler simple, mais elle cache plusieurs pièges techniques qui peuvent bloquer les utilisateurs. Le problème principal reste la mauvaise configuration du Document Root, suivi des erreurs liées aux ports, à la base de données et aux permissions. Grâce aux solutions proposées dans cet article, il est possible de résoudre rapidement ces problèmes et de garantir une installation stable et sécurisée. En 2026, maîtriser ce type d’installation devient essentiel pour toute entreprise ou intégrateur souhaitant exploiter pleinement la puissance de Dolibarr.