1. Introduzione
L’installazione di Dolibarr ERP CRM su un NAS Synology è una scelta molto diffusa tra le aziende che desiderano ospitare il proprio ERP internamente, mantenendo al contempo l’accesso remoto. Tuttavia, con il rilascio della versione 23 di Dolibarr, diversi utenti hanno riscontrato problemi tecnici durante l’installazione o la migrazione da versioni precedenti.
Il thread del forum analizzato evidenzia due problematiche principali: un errore SQL durante l’installazione e incompatibilità legate alle versioni di PHP disponibili su Synology. Questo articolo propone un’analisi dettagliata di tali problemi e delle soluzioni suggerite nella discussione.
2. Contesto tecnico dell’installazione su Synology
L’ambiente Synology si basa generalmente su:
- DSM (DiskStation Manager)
- Web Station
- Apache o Nginx
- PHP (versioni multiple)
- MariaDB
Per installare correttamente Dolibarr, è necessario configurare adeguatamente questi componenti, in particolare Web Station, PHP e il database.
3. Problema principale n°1: errore SQL durante l’installazione
Durante l’installazione di Dolibarr V23, l’utente incontra il seguente errore:
➡️ “DB_ERROR_1170 BLOB/TEXT column ‘linktoref’ used in key specification without a key length”
3.1 Analisi del problema
Questo errore è legato a MySQL/MariaDB. Si verifica quando una colonna di tipo TEXT o BLOB viene utilizzata in un indice senza specificare la lunghezza della chiave.
3.2 Impatto reale
Secondo le risposte del forum:
- l’errore non è bloccante
- il database viene creato correttamente
- le tabelle sono presenti
???? Conclusione: il sistema rimane funzionante nonostante l’errore
4. Soluzione proposta per l’errore SQL
La risposta principale nel forum è la seguente:
➡️ se non si utilizzano i log inalterabili, l’errore può essere ignorato
4.1 Spiegazione
Il campo interessato è legato ai log sicuri (inalterabili).
Se questa funzionalità non viene utilizzata:
- nessun impatto funzionale
- nessuna azione urgente necessaria
5. Problema principale n°2: compatibilità PHP su Synology
Un altro problema importante riguarda la versione di PHP:
➡️ la documentazione di Dolibarr raccomanda PHP 7.4
➡️ ma questa versione non è più disponibile su alcuni NAS Synology recenti
6. Analisi del problema PHP
Sui sistemi Synology DSM più recenti:
- PHP 7.4 è spesso rimosso
- sono disponibili solo versioni più recenti
Questo crea problemi di compatibilità per:
- versioni più vecchie di Dolibarr (ad esempio v17)
- migrazioni verso la versione 23
7. Soluzioni proposte nel forum
7.1 Aggiornare Dolibarr prima della migrazione
➡️ Raccomandazione:
Aggiornare Dolibarr a una versione recente prima di cambiare ambiente
7.2 Installazione locale temporanea
➡️ Soluzione adottata dall’utente:
- installare Dolibarr su un PC locale
- ripristinare il backup
- continuare l’attività
Questo approccio consente di aggirare i limiti del NAS.
7.3 Utilizzare Docker come alternativa
➡️ Soluzione consigliata:
Installare Dolibarr tramite Docker su Synology
Vantaggi:
- indipendenza dalle versioni PHP
- installazione più stabile
- compatibilità completa con Dolibarr V23
8. Problema indiretto: migrazione da una versione precedente (v17)
Il forum evidenzia anche una difficoltà comune:
➡️ migrazione diretta da una versione obsoleta
Rischi:
- incompatibilità PHP
- errori nel database
- perdita di funzionalità
9. Buone pratiche per la migrazione
L’approccio corretto consiste in:
- aggiornare Dolibarr progressivamente
- testare ogni versione intermedia
- verificare la compatibilità PHP
- migrare successivamente al nuovo ambiente
10. Buone pratiche generali per Synology
Secondo la documentazione ufficiale:
- utilizzare Web Station
- installare Apache 2.4
- installare MariaDB 10
- configurare correttamente PHP
- aprire le porte necessarie
11. Perché Synology presenta sfide specifiche
Gli ambienti NAS Synology introducono alcune limitazioni:
- gestione limitata delle versioni PHP
- dipendenza dagli aggiornamenti DSM
- configurazione web specifica
- compatibilità variabile in base agli aggiornamenti
12. Alternative consigliate per Dolibarr su NAS
12.1 Docker (soluzione moderna)
- isolamento completo
- compatibilità garantita
- distribuzione rapida
12.2 Installazione locale + migrazione
- maggiore sicurezza dei dati
- riduzione dei tempi di inattività
12.3 Hosting esterno
- maggiore semplicità
- manutenzione ridotta
13. Impatto per gli utenti
Questi problemi possono causare:
- interruzioni del servizio
- perdita di accesso al sistema
- difficoltà nelle migrazioni
Con le giuste pratiche:
- la continuità del servizio è garantita
- la migrazione è controllata
- la stabilità del sistema migliora
14. Conclusione
Il thread del forum relativo all’installazione di Dolibarr V23 su Synology evidenzia due problemi principali: un errore SQL non bloccante e limitazioni legate alla compatibilità PHP. Le soluzioni proposte dimostrano che queste difficoltà possono essere superate adottando strategie adeguate, come l’utilizzo di Docker o aggiornamenti progressivi. Nel 2026, l’installazione di Dolibarr su Synology rimane una soluzione potente, ma richiede competenze tecniche per evitare problemi legati all’evoluzione del sistema e delle dipendenze.