Guide complet Mac installation Dolibarr sur MAMP

J’ai longtemps bataillé à mes débuts pour installer et configurer Dolibarr en local sur mon Mac, je n’y connaissait rien.
J’utilise maintenant une solution hébergée mais je continue régulièrement à faire des tests en local et j’ai donc mis au point une procédure rapide et efficace que je partage avec vous.
Dolibarr est un super logiciel et je souhaite le rendre le plus accessible possible sur Mac.
Cette procédure vous permettra de vous lancer.
Quand votre entreprise aura grandie, ce que je vous souhaite, et que vos besoins se seront élargis, libre à vous ensuite de vous tourner vers un prestataire agréé qui saura vous accompagner à partir de l’existant.

Les étapes ci-dessous peuvent paraitre rebutantes à priori, mais cette procédure me permet de partir de zéro et d’avoir un Dolibarr fonctionnel en moins de 5 minutes.
Je mettrais à jour en fonction des retours.
Une fois cette installation faite, à priori tout restera fonctionnel même si mise à jour Mac OS ou MAMP.

Avant toute chose, je vous implore de mettre en place une solution de backup.
Au plus simple utilisez au moins Time Machine sur un disque dur externe, c’est vraiment le minimum.
Quand vous aurez commencé à utiliser Dolibarr, vous ne pourrez plus vous en passer. Si votre base de données Dolibarr est régulièrement sauvegardée, elle pourra vous suivre partout. Nouvel ordinateur, ordinateur cassé, perdu ou volé, migration vers une solution en ligne, etc. Les possibilités sont énormes, alors ne jouez pas avec le feux. SAUVEGARDES et BACKUPS !
Je précise également que la simple sauvegarde Time Machine ne suffit pas pour Dolibarr, il faut obligatoirement passer par la fonction “Outils d’administration / Sauvegarde / Générer sauvergarde” de ce dernier.

*** Guide au 17/03/2019 ***

Prérequis : Version Mac OS X 10.10 minimum.

Téléchargez MAMP (version 5.3)
https://www.mamp.info/en/downloads/

Téléchargez Dolibarr (version 8.0.4 recommandée)
https://sourceforge.net/projects/dolibarr/files/Dolibarr%20ERP-CRM/

• Installer MAMP
Continuez à travers les fenêtres de licence, etc.
Sélectionnez votre disque interne, et sur l’étape d’après cliquez sur le bouton en bas à gauche “customize”.
Décochez “MAMP Pro”, seul “MAMP” est sélectionné obligatoirement.
Cliquez sur “Install” et attendez la fin de l’installation.
Quand MAMP est installé, choisissez si oui ou non vous voulez mettre le fichier d’installation à la corbeille. Personnellement je préfère choisir “Keep” pour garder le fichier sous le coude.

• Décompressez le .ZIP de Dolibarr (dolibarr-8.0.4) dans vos Téléchargements.
Déplacez ce dossier à la racine du dossier MAMP qui se trouve désormais dans le dossier Applications du Finder.

• Configurez l’application MAMP
Ouvrez l’application MAMP.
Commencez par décocher “Show this window when starting” en bas de la fenêtre “MAMP Cloud functions” et fermez la fenêtre.
Allez dans le menu “MAMP / Préférences” en haut à gauche dans la barre de menu.
Dans l’onglet “Général” cochez la case “Start servers”.
Dans l’onglet “Ports” notez le port Apache, qui doit être 8888 par défaut.
Dans l’onglet “Cloud”, assurez vous que “Use Cloud” est décoché.
Dans l’onglet “Web Server” à “Document Root”, cliquez sur le bouton “Select” et naviguez vers le dossier “Applications / MAMP / dolibarr-8.0.4” et sélectionner une fois le dossier “htdocs”.
Cliquez sur “Select” en bas à droite de la fenêtre.
Puis cliquez sur le bouton “OK”

MAMP est désormais configuré.
Vous pouvez manuellement démarrer et éteindre le serveur qui va vous faire tourner Dolibarr.
Par défaut nous l’avons configuré pour démarrer le serveur à chaque fois que MAMP est lancé.
Vous l’aurez compris, si MAMP n’est pas lancé et que les voyants “Apache” et “SQL” ne sont pas au vert, pas de Dolibarr.
(Vous pouvez aller dans “Préférences Système / Utilisateurs / ouverture” de votre Mac pour ajouter MAMP à la liste et faire en sorte que MAMP s’ouvre automatiquement à chaque fois que vous démarrez votre Mac).

• Installer et configurer Dolibarr
Lancer votre navigateur et rentrer l’adresse “localhost:8888”
Choisissez la langue, puis “étape suivante”
Bouton “Démarrer” pour la première installation, et « étape suivante ».

Sous les options “Serveur Web” laissez tout par défaut.
Sous les options “Base de Données” :
- Cochez la case “Créer la base de données”
- Choisissez un identifiant et un mot de passe (pour la base de données SQL, différent des utilisateurs Dolibarr)
- Cochez la case “Créer le propriétaire”
- "Accès super utilisateur” va apparaitre en dessous. Utilisez le user par défaut de MAMP c’est à dire identifiant “root” et mot de passe “root”
- Cliquez sur “suivant”

Dolibarr vous indique normalement que tout est OK :
Vous avez donc créé une base de données SQL “dolibarr”, ainsi qu’un administrateur qui peu gérer cette base. Gardez bien cet identifiant car c’est avec lui que vous pourrez gérer les sauvegardes et restaurations de votre base de données.

- Cliquez sur le bouton “suivant” et laissez Dolibarr faire son truc. Un fois que tout est OK, cliquez à nouveau sur “suivant” et vous arrivez sur la page de création de l’administrateur Dolibarr.
- Choisissez un identifiant et un mot de passe. Il peut être différent ou pareil que celui de l’étape précédente, mais notez que se sont deux utilisateurs distincts.
Cliquez sur “suivant”
Dolibarr vous prévient ensuite que la création du user est OK, mais vous averti que “pour des raisons de sécurité” “il est conseillé de placer dans le répertoire document de Dolibarr un fichier nommé install.lock en lecture seule” : Nous y reviendrons, car dans une utilisation strictement hors-réseau ça ne nous concerne pas, mais sachez que dès que vous vous connectez à un réseau, MAMP expose Dolibarr et votre base de données aux autres.
- Cliquez sur “accéder à Dolibarr” en utilisant le compte administrateur Dolibarr ci-dessus.

Maintenant Dolibarr fonctionne en local sur votre installation de MAMP. Vous devez configurer toutes les options propres à votre société avant de continuer : “Les informations de configuration obligatoire doivent être renseignées”.
Vous effectuerez tous les réglages nécéssaires à la première mise en route de Dolibarr ainsi que l’activation des modules requis en vous référant au Wiki de Dolibarr ainsi que ce forum.

• Une fois Dolibarr en place et que vous avez accès à la page “Accueil” de Dolibarr, en bas de cette page vous verrez deux avertissements de sécurité :
- Ouvrez l’application TextEdit et sauvegardez un document vierge intitulé “install.lock” dans le dossier “Applications / MAMP / dolibarr-8.0.4 / documents”. Aller dans ce dossier avec le Finder, sélectionner le fichier qui doit normalement s’appeler “install.lock.rtf” et aller dans le menu Fichier / Informations (raccourci pomme-i). Dans la case du nom de fichier, supprimer le “.rtf” à la fin, touche entrée puis “utiliser .lock” quand le Finder vous le demande.
Retournez dans Dolibarr et rafraichir la page, normalement le premier avertissement a disparu.
- Dans le Finder, naviguez vers le dossier “Applications / MAMP / dolibarr-8.0.4 / htdocs / conf” et sélectionnez le fichier “conf.php”. Aller dans les informations (raccourci pomme-i) et en bas de la fenêtre, dans la partie “partage et autorisations” basculer toutes les lignes sur “lecture seule”.
Fermez la fenêtre, retourner sur Dolibarr et rafraichir la page.
Normalement les deux avertissements en bas de la page d’accueil ont disparus.

Dolibarr est désormais opérationnel.

• Sauvegardez la base de données régulièrement :
Le plus simple c’est d’aller très régulièrement dans Dolibarr sous “Outils d’administration / Sauvegarde” et cliquez sur le bouton “générer sauvegarde”.
Ces fichiers sont générés dans “Applications / MAMP / dolibarr-8.0.4 / documents / admin / backup”
C’est l’ensemble du dossier “Applications / MAMP / dolibarr-8.0.4 / documents” que vous devrez sauvegarder. Sur Mac si votre Time Machine fonctionne correctement ça devrait suffire mais rien ne vous empêche de prendre des précautions supplémentaires…
Quand vous serez plus avancé avec Dolibarr, vous pourrez commencer à mettre en place des solutions type CRON pour réaliser des sauvegardes automatiques de la base de données.

4 J'aimes

Salut initialsBB,
intéressante ta démarche de partage,
et expérience riche de réussite et de tâtonnement apparemment !

Je vais faire mon VRP :wink:
« Le forum c’est bien, le wiki c’est mieux ! » (mouais… ça rime même pas…)

Si ça te tente: demande un accès éditeur au wiki et capitalise ton expérience sous mac pour ceux qui chercheraient de l’aide.
https://wiki.dolibarr.org/index.php/Accueil

Si tu n’as pas le temps, je ferais des gros copier/coller de ce post et je le mettrai en forme pour le wiki. (mais honnêtement : si tu t’y colles c’est mieux car je vais avoir la flemme de tenir à ajour le wiki en fonction de ton post, je me connais :wink: )

@+

1 J'aime

Bonjour Arre,
OK pour contribuer au Wiki. Ça fait un bail que j’ai pas mis le nez dans un Wiki mais je m’y remettrais bientôt !
En attendant les retours ici sont les bienvenus, comme ça j’affinerais le process.

1 J'aime

Bonjour,
Je viens de suivre votre tuto pas à pas et l’installation sur mojave c’est bien déroulée … maintenant place à la prise en main de l’outil.
Merci pour votre support :happy:

1 J'aime

Bonjour,

Merci beaucoup pour ce tuto précieux ! J’ai pu installer Doli comme sur des roulettes.

Par contre j’ai actuellement un petit problème d’import, si quelqu’un a une idée ?
www.dolibarr.fr/forum/t/resolu-probleme-import-prospects/29782/1

Merci d’avance :happy:

Bonjour,
J’ai wikifié la page:
https://wiki.dolibarr.org/index.php/Installation_sur_MacOSX
Merci

4 J'aimes

Merci Yves !
Dès que j’ai un peu de temps je me charge d’y mettre des captures d’écran pour rendre la chose plus visuelle.

En effet, ça peut être bien.

Bonjour à tous,

Je ne sais pas trop dans quelle catégorie mettre ce post…
Je suis en panique complète car depuis mon retour de vacances impossible d’accéder à Dolibarr…
Je sais juste que pendant mon absence une de mes collègues à tenter de s’y connecter pour la première fois depuis l’ordinateur source sans succès.
Voici la capture d’écran du résultat de la page habituelle de connexion :


Des idées ? Au minimum pour récupérer la bdd ?
Merci par avance !

Bonjour,

Soit l’ordinateur source à changer d’adresse IP
SOit le serveur MAMP ne tourne pas sur la machine source.

A mon avis c’est la première solution vu que vous devez être en DHCP et non IP Fixe

Donc :

  1. Verifier sur l’ordinateur source ça marche toujours => Sinon regarder si MAMP est bien démarré
  2. Si le point 1 marche, il faut alors obtenir la nouvelle adresse IP du PC source pour s’y connecter (et de préférence passer en IP FIxe).
1 J'aime

Bonjour ksar,

Merci pour cette réponse. MAMP est bien démarré sr l’ordi source ! L’ordi source est mon poste de travail.
Comment faire pour obtenir la nouvelle IP ? Et surtout pourquoi après plusieurs mois aurait-elle subitement changée ?
Merci par avance :slight_smile:

Slt
Tu va ds Preferences Systeme>Reseau

1 J'aime

La question serait plutôt pourquoi ça n’a pas changé plus tôt.
Il peut être intéressant de regarder du côté de « Bonjour » 'microDNS) pour faciliter la vie à ce propos.

1 J'aime

Bonjour pm17,

J’y suis. Rien à part la box internet. Un menu difficilement accessible ou je peux commencer à poser des bombes dans le bureau ?

Bonjour Yves 57,

Merci pour cette réponse. En version compréhensible pour un individu lambda ?

Si tu veux mettre en place quelque chose qui fonctionne, il faudra dépasser le stade de l’individu lambda.
Concernant « Bonjour » : https://fr.wikipedia.org/wiki/Zeroconf#Apple_Bonjour

Ça fonctionnait avant qu’une collègue ne mette le nez dedans…
Je fais avec le temps, les moyens et les compétences que j’ai, donc le stade de l’individu lambda risque de durer :slight_smile:

Bonjour BulleFlottes,
Est-ce qu’il y a eu des mises à jours OS X depuis ? En mode automatique ?

Dans les préférences systèmes / partage, il y a possibilité de trouver le nom de partage de l’ordinateur qui héberge Dolibarr/Mamp. C’est par défaut dans le style « iMac-bureau.local »

Essaye de rentrer cette adresse dans l’ordinateur qui consulte Dolibarr dans le style « iMac-bureau.local:8888 »

1 J'aime

Bonjour initialsBB,

Encore éternelle reconnaissance pour le tuto d’installation.
Merci de t’intéresser à mon cas, car ta technique fonctionne ! As tu une explication de texte ?
Merci merci merci merci :smiley:
J’ai eu tellement peur d’avoir perdu tout mon travail…

Pour info normalement les mises à jour ne se font pas automatiquement sur mon poste.
Mais j’ai été absente du bureau du 1er septembre à ce lundi donc va savoir ce qui a pu être fait et je n’ai pas accès aux mises à jour antérieure à 30 jours… Assez maigre comme piste :