1. Introducción
La instalación de Dolibarr ERP CRM en un NAS Synology es una solución muy utilizada por empresas que desean alojar su ERP internamente, manteniendo al mismo tiempo acceso remoto. Sin embargo, con el lanzamiento de la versión 23 de Dolibarr, varios usuarios han encontrado problemas técnicos durante la instalación o la migración desde versiones anteriores.
El hilo del foro analizado destaca dos problemas principales: un error SQL durante la instalación y problemas de compatibilidad relacionados con las versiones de PHP disponibles en Synology. Este artículo ofrece un análisis detallado de estos problemas y de las soluciones propuestas en la discusión.
2. Contexto técnico de la instalación en Synology
El entorno Synology se basa generalmente en:
- DSM (DiskStation Manager)
- Web Station
- Apache o Nginx
- PHP (múltiples versiones)
- MariaDB
Para instalar correctamente Dolibarr, es necesario configurar adecuadamente estos componentes, especialmente Web Station, PHP y la base de datos.
3. Problema principal n.º 1: error SQL durante la instalación
Durante la instalación de Dolibarr V23, el usuario encuentra el siguiente error:
➡️ “DB_ERROR_1170 BLOB/TEXT column ‘linktoref’ used in key specification without a key length”
3.1 Análisis del problema
Este error está relacionado con MySQL/MariaDB. Ocurre cuando una columna de tipo TEXT o BLOB se utiliza en un índice sin especificar la longitud de la clave.
3.2 Impacto real
Según las respuestas del foro:
- el error no es bloqueante
- la base de datos se crea correctamente
- las tablas están presentes
???? Conclusión: el sistema sigue funcionando a pesar del error
4. Solución propuesta para el error SQL
La principal respuesta en el foro indica:
➡️ si no se utilizan los registros inmutables, el error puede ignorarse
4.1 Explicación
El campo afectado está relacionado con los registros seguros (inalterables).
Si esta funcionalidad no se utiliza:
- no hay impacto funcional
- no es necesaria ninguna acción urgente
5. Problema principal n.º 2: compatibilidad PHP en Synology
Otro problema importante está relacionado con la versión de PHP:
➡️ la documentación de Dolibarr recomienda PHP 7.4
➡️ pero esta versión ya no está disponible en algunos NAS Synology recientes
6. Análisis del problema de PHP
En versiones recientes de DSM de Synology:
- PHP 7.4 suele eliminarse
- solo están disponibles versiones más recientes
Esto genera problemas de compatibilidad para:
- versiones antiguas de Dolibarr (por ejemplo, v17)
- procesos de migración hacia la versión 23
7. Soluciones propuestas en el foro
7.1 Actualizar Dolibarr antes de migrar
➡️ Recomendación:
Actualizar Dolibarr a una versión reciente antes de cambiar de entorno
7.2 Instalación local temporal
➡️ Solución adoptada por el usuario:
- instalar Dolibarr en un PC local
- restaurar la copia de seguridad
- continuar la actividad
Este enfoque permite evitar las limitaciones del NAS.
7.3 Usar Docker como alternativa
➡️ Solución recomendada:
Instalar Dolibarr mediante Docker en Synology
Ventajas:
- independencia de las versiones de PHP
- instalación más estable
- compatibilidad completa con Dolibarr V23
8. Problema indirecto: migración desde una versión antigua (v17)
El foro también destaca una dificultad frecuente:
➡️ migración directa desde una versión obsoleta
Riesgos:
- incompatibilidades con PHP
- errores en la base de datos
- pérdida de funcionalidades
9. Buenas prácticas para la migración
El enfoque correcto consiste en:
- actualizar Dolibarr progresivamente
- probar cada versión intermedia
- verificar la compatibilidad de PHP
- migrar posteriormente al nuevo entorno
10. Buenas prácticas generales para Synology
Según la documentación oficial:
- utilizar Web Station
- instalar Apache 2.4
- instalar MariaDB 10
- configurar correctamente PHP
- abrir los puertos necesarios
11. Por qué Synology presenta desafíos específicos
Los entornos Synology NAS presentan varias limitaciones:
- gestión limitada de versiones PHP
- dependencia de actualizaciones DSM
- configuración web específica
- compatibilidad variable según versiones del sistema
12. Alternativas recomendadas para Dolibarr en NAS
12.1 Docker (solución moderna)
- aislamiento completo
- compatibilidad garantizada
- despliegue rápido
12.2 Instalación local + migración
- mayor seguridad de los datos
- evitar interrupciones del servicio
12.3 Hosting externo
- mayor simplicidad
- menor mantenimiento
13. Impacto para los usuarios
Estos problemas pueden provocar:
- interrupciones del servicio
- pérdida de acceso al sistema
- dificultades en las migraciones
Con buenas prácticas:
- se garantiza la continuidad del servicio
- la migración se controla mejor
- mejora la estabilidad del sistema
14. Conclusión
El hilo del foro sobre la instalación de Dolibarr V23 en Synology pone de manifiesto dos problemas principales: un error SQL no bloqueante y limitaciones relacionadas con la compatibilidad de PHP. Las soluciones propuestas demuestran que estas dificultades pueden superarse mediante estrategias adecuadas, como el uso de Docker o actualizaciones progresivas. En 2026, la instalación de Dolibarr en Synology sigue siendo una solución potente, pero requiere conocimientos técnicos sólidos para evitar problemas relacionados con la evolución del sistema y sus dependencias.