1. Introduzione

L’installazione di Dolibarr ERP CRM su un ambiente locale Mac tramite MAMP è una pratica comune tra sviluppatori, integratori e aziende che desiderano testare o distribuire un ERP in locale. Tuttavia, nonostante la semplicità apparente del processo, molti utenti incontrano difficoltà tecniche durante l’installazione, come evidenziato nel forum Dolibarr.
Questi problemi sono particolarmente frequenti tra i principianti o tra coloro che non hanno familiarità con gli ambienti Apache, MySQL e PHP. Questo articolo analizza in dettaglio i problemi riscontrati, le loro cause tecniche e le soluzioni già proposte, aggiungendo anche raccomandazioni avanzate per garantire un’installazione corretta nel 2026.

2. Contesto tecnico dell’installazione di Dolibarr su Mac

Prima di analizzare i problemi, è importante comprendere l’ambiente tecnico.
Dolibarr richiede:

• Un server web (Apache)
• Un server di database (MySQL o MariaDB)
• PHP
  Su Mac, lo strumento più utilizzato per simulare questo ambiente è MAMP.

Il processo base è semplice:

• Installare MAMP
• Copiare Dolibarr nella directory del server
• Avviare l’installazione tramite browser

Tuttavia, possono verificarsi diversi problemi durante queste fasi.

3. Problema principale segnalato nel forum

Il problema più comune segnalato dagli utenti è il seguente:

➡️ Dopo aver installato MAMP e posizionato Dolibarr nella cartella, l’utente accede a:
http://localhost:8888/

Invece dell’installer di Dolibarr, viene visualizzata la pagina predefinita di MAMP.

Questo è un problema critico perché impedisce completamente l’accesso a Dolibarr.

4. Analisi tecnica del problema

Questo comportamento è generalmente causato da una configurazione errata del “Document Root” (la directory principale del server web).

Per impostazione predefinita, MAMP punta a:
/Applications/MAMP/htdocs

Quindi, anche se Dolibarr è installato altrove, Apache non riesce a trovarlo.

Secondo la documentazione ufficiale, questo percorso deve essere configurato correttamente.

5. Soluzione 1: Configurare correttamente il Document Root

Questa è la soluzione principale raccomandata nel forum.

Passaggi:

1. Aprire MAMP
2. Andare su Preferences
3. Aprire la scheda Web Server
4. Modificare il Document Root
5. Impostarlo su:
   /Applications/MAMP/dolibarr/htdocs

Poi:

• Riavviare i server
• Ricaricare localhost

???? Risultato: Dolibarr diventa accessibile

6. Soluzione 2: Spostare Dolibarr in htdocs

Un’alternativa più semplice è:

Spostare Dolibarr nella directory:
/Applications/MAMP/htdocs/dolibarr

Poi accedere a:
http://localhost:8888/dolibarr/htdocs

Questa soluzione è spesso più facile per i principianti.

7. Problemi legati al database

Un altro problema frequente riguarda la configurazione MySQL.

Errori comuni:

• Impossibile creare il database
• Accesso negato
• Credenziali errate

Soluzione standard:

• Utilizzare le credenziali predefinite:
  • Utente: root
  • Password: root
• Attivare la creazione del database

8. Problema della porta Apache

Molti utenti dimenticano che MAMP utilizza la porta 8888.

Quindi:

• ❌ http://localhost → non funziona
• ✔ http://localhost:8888 → funziona

Questo dettaglio è spesso causa di errore.

9. Problemi di configurazione PHP

Dolibarr richiede una versione PHP compatibile.

Problemi possibili:

• Versione PHP troppo vecchia
• Estensioni mancanti

Soluzione:

• Usare PHP ≥ 7.2
• Attivare le estensioni necessarie:
  • mysqli
  • gd
  • curl

10. Problemi di permessi dei file

Un altro problema frequente riguarda i permessi dei file.

➡️ Dolibarr non riesce a scrivere in alcune cartelle

Soluzione:

• Controllare i permessi
• Abilitare la scrittura

Cartelle importanti:

• documents
• htdocs/conf

11. Problemi di sicurezza dopo l’installazione

Dopo l’installazione, Dolibarr può mostrare avvisi come:

• Mancanza del file install.lock
• File di configurazione modificabile

Soluzione ufficiale:

• Creare install.lock
• Rendere conf.php di sola lettura

12. Evoluzione su Mac nel 2026

Un punto importante per il 2026:

Soluzioni come DoliMamp non sono più mantenute.

➡️ Gli utenti devono installare Dolibarr manualmente

L’installer automatico per Mac non è più disponibile.

13. Alternative consigliate

Per evitare problemi con MAMP, si possono considerare alternative:

Opzione 1: Docker

• Installazione rapida
• Ambiente isolato

Opzione 2: Bitnami

• Installazione semplificata

Opzione 3: Hosting cloud

• Nessuna configurazione locale

14. Buone pratiche per un’installazione riuscita

Per evitare problemi:

1. Installare MAMP correttamente
2. Verificare le porte
3. Configurare il Document Root
4. Controllare PHP
5. Creare il database
6. Proteggere l’installazione

15. Impatto per aziende e integratori

Un’installazione fallita può causare:

• Perdita di tempo
• Frustrazione tecnica
• Cattiva prima impressione

Un’installazione riuscita consente:

• Test rapidi
• Formazione del team
• Sviluppo di moduli

16. Valore SEO e strategico

Il tema “Dolibarr MAMP Mac” ha un forte potenziale SEO perché:

• È un problema frequente
• Molti utenti cercano soluzioni
• Esistono pochi guide complete

???? Questo lo rende un ottimo argomento per generare traffico qualificato.

17. Conclusione

L’installazione di Dolibarr su Mac con MAMP può sembrare semplice, ma nasconde diverse difficoltà tecniche che possono bloccare gli utenti. Il problema principale è la configurazione errata del Document Root, seguito da errori legati alla porta, al database e ai permessi dei file. Applicando le soluzioni presentate in questa guida, è possibile risolvere rapidamente questi problemi e ottenere un’installazione stabile e sicura. Nel 2026, padroneggiare questo tipo di installazione è fondamentale per qualsiasi azienda o integratore che voglia sfruttare appieno le potenzialità di Dolibarr.