1. Introduction
L’installation de Dolibarr ERP CRM sur un NAS Synology est une solution très prisée par les entreprises souhaitant héberger leur ERP en interne, tout en bénéficiant d’un accès distant. Cependant, avec l’arrivée de la version 23 de Dolibarr, plusieurs utilisateurs ont rencontré des problèmes techniques lors de l’installation ou de la migration depuis des versions plus anciennes.
Le sujet du forum analysé met en lumière deux types de problèmes majeurs : une erreur SQL lors de l’installation et des incompatibilités liées aux versions de PHP disponibles sur Synology. Cet article propose une analyse complète de ces problèmes ainsi que les solutions évoquées dans le thread.
2. Contexte technique de l’installation sur Synology
L’environnement Synology repose généralement sur :
- DSM (DiskStation Manager)
- Web Station
- Apache ou Nginx
- PHP (versions multiples)
- MariaDB
Pour installer Dolibarr, il est nécessaire de configurer correctement ces composants, notamment Web Station, PHP et la base de données.
3. Problème principal n°1 : erreur SQL lors de l’installation
Lors de l’installation de Dolibarr V23, l’utilisateur rencontre l’erreur suivante :
➡️ “DB_ERROR_1170 BLOB/TEXT column ‘linktoref’ used in key specification without a key length”
3.1 Analyse du problème
Cette erreur est liée à la base de données MySQL/MariaDB. Elle apparaît lorsqu’une colonne de type TEXT ou BLOB est utilisée dans un index sans longueur définie.
3.2 Impact réel
Selon les réponses du forum :
- l’erreur n’est pas bloquante
- la base de données est bien créée
- les tables sont présentes
???? Conclusion : le système reste fonctionnel malgré l’erreur
4. Solution proposée pour l’erreur SQL
La réponse principale dans le forum indique :
➡️ si vous n’utilisez pas les logs inaltérables, l’erreur peut être ignorée
4.1 Explication
Le champ concerné est lié aux logs sécurisés (inaltérables).
Si cette fonctionnalité n’est pas utilisée :
- aucun impact fonctionnel
- aucune action urgente requise
5. Problème principal n°2 : incompatibilité PHP sur Synology
Un second problème majeur concerne la version PHP :
➡️ la documentation Dolibarr recommande PHP 7.4
➡️ mais cette version n’est plus disponible sur certains NAS Synology récents
6. Analyse du problème PHP
Sur Synology DSM récents :
- PHP 7.4 est souvent supprimé
- seules des versions plus récentes sont disponibles
Cela pose un problème pour :
- anciennes versions de Dolibarr (ex : v17)
- migrations vers v23
7. Solutions proposées dans le forum
7.1 Faire la montée de version avant migration
➡️ Recommandation :
Mettre à jour Dolibarr vers une version récente avant de changer d’environnement
7.2 Installer Dolibarr en local temporairement
➡️ Solution adoptée par l’utilisateur :
- installer Dolibarr sur un PC local
- restaurer le backup
- continuer l’activité
Cette approche permet de contourner le blocage sur le NAS.
7.3 Utiliser Docker comme solution alternative
➡️ Solution recommandée :
Installer Dolibarr via Docker sur Synology
Avantages :
- indépendance vis-à-vis des versions PHP
- installation plus stable
- compatibilité avec Dolibarr 23
8. Problème indirect : migration depuis une ancienne version (v17)
Le sujet met aussi en évidence une difficulté fréquente :
➡️ migration directe depuis une ancienne version
Risques :
- incompatibilités PHP
- erreurs base de données
- perte de fonctionnalités
9. Bonne pratique recommandée pour la migration
La méthode correcte consiste à :
- Mettre à jour progressivement Dolibarr
- Tester chaque version intermédiaire
- Vérifier la compatibilité PHP
- Migrer ensuite vers le nouvel environnement
10. Bonnes pratiques générales pour Synology
D’après la documentation officielle :
- utiliser Web Station
- installer Apache 2.4
- installer MariaDB 10
- configurer correctement PHP
- ouvrir les ports nécessaires
11. Pourquoi Synology pose des défis spécifiques
Les NAS Synology introduisent plusieurs contraintes :
- gestion des versions PHP limitée
- dépendance à DSM
- configuration web spécifique
- compatibilité variable selon les mises à jour
12. Alternatives recommandées pour Dolibarr sur NAS
12.1 Docker (solution moderne)
- isolation complète
- compatibilité garantie
- déploiement rapide
12.2 Installation locale + migration
- sécuriser les données
- éviter les interruptions
12.3 Hébergement externe
- simplicité
- maintenance réduite
13. Impact pour les utilisateurs
Les problèmes rencontrés peuvent entraîner :
- interruption d’activité
- perte d’accès au système
- difficultés de migration
Mais avec les bonnes pratiques :
- continuité de service assurée
- migration maîtrisée
- meilleure stabilité
14. Conclusion
Le sujet du forum sur l’installation de Dolibarr V23 sur Synology met en évidence deux problématiques majeures : une erreur SQL non bloquante et une incompatibilité liée aux versions PHP. Les solutions proposées montrent qu’il est possible de contourner ces difficultés en adoptant des approches adaptées, notamment via Docker ou une migration progressive. En 2026, l’installation de Dolibarr sur Synology reste une solution puissante, mais nécessite une bonne maîtrise technique pour éviter les pièges liés aux évolutions du système et des dépendances.