Dolibarr ERP & CRM es una potente herramienta de código abierto que permite a empresas de cualquier tamaño gestionar contabilidad, inventario, relaciones con clientes, recursos humanos y mucho más. Aunque es fácil de usar, el proceso de instalación puede confundir incluso a usuarios experimentados si se pasan por alto conceptos fundamentales. Una instalación limpia y bien planificada es la base para un funcionamiento estable, escalabilidad futura y un tiempo de inactividad mínimo.

En este artículo completo, te guiaremos a través de una lista de comprobación detallada para instalar Dolibarr y te mostraremos los 7 errores más comunes que debes evitar para lograr una instalación estable y segura. Ya sea que instales Dolibarr localmente, en hosting compartido, en un VPS o mediante Docker, esta guía te ayudará a evitar errores comunes que pueden conducir a pérdida de datos, problemas de rendimiento o vulnerabilidades de seguridad.

Por qué la preparación es clave

Antes de comenzar, debes entender que Dolibarr maneja datos empresariales críticos. Un sistema mal configurado, dependencias faltantes o una instalación insegura pueden provocar problemas costosos. Seguir una lista de comprobación asegura que tu instalación sea segura, eficiente y preparada para el futuro.

Aquí están los errores más comunes – y cómo evitarlos.

Error nº 1: Ignorar los requisitos del sistema

Un error común es asumir que cualquier entorno de alojamiento puede ejecutar Dolibarr sin problemas. Dolibarr se basa en PHP y requiere MySQL o MariaDB. Asegúrate de que tu sistema cumple con los requisitos técnicos mínimos:

Requisitos mínimos para Dolibarr (versión actual):

• PHP 7.2 o superior (se recomienda PHP 8.0+)

• MySQL 5.0+ o MariaDB

• Servidor web compatible (Apache, Nginx, etc.)

• Extensiones PHP activadas: gd, json, mbstring, pdo_mysql, curl, zip

Solución:

• Usa phpinfo() o php -m para revisar las extensiones instaladas

• Utiliza un stack LAMP/LEMP o herramientas como XAMPP, WAMP o Docker

• Asegúrate de que los permisos de escritura están correctamente configurados en las carpetas documents/ y conf/

Saltar esta verificación puede generar errores de instalación o problemas difíciles de rastrear.

Error nº 2: Configuración incorrecta de la base de datos

Es común crear una base de datos MySQL sin asignar correctamente los permisos o usar contraseñas débiles.

Escenarios críticos:

• No crear un usuario MySQL dedicado

• Usar la cuenta root

• No asignar todos los privilegios necesarios

• Usar caracteres especiales que causan errores en los archivos de configuración

Solución:

• Crea una base de datos dedicada para Dolibarr

• Crea un usuario MySQL específico (evita usar root)

• Usa una contraseña segura

• Asigna todos los privilegios necesarios al usuario

• Evita caracteres especiales como @, $, #, & si no sabes cómo gestionarlos correctamente

Error nº 3: No eliminar el directorio de instalación

Después de completar la instalación web, muchos usuarios olvidan eliminar o restringir el acceso al directorio /install/. Esto representa un riesgo de seguridad grave: un atacante podría reiniciar la instalación y sobrescribir tus datos.

Solución:

• Elimina el directorio /install/ inmediatamente después de la instalación

• Si no puedes eliminarlo, revoca los permisos de acceso

Dolibarr te avisará si el directorio aún existe – pero es mejor prevenir desde el principio.

Error nº 4: No configurar HTTPS

Por defecto, Dolibarr se accede mediante HTTP – lo cual es muy arriesgado, ya que los datos se transmiten sin cifrado.

Riesgos:

• Las contraseñas pueden ser interceptadas

• Las sesiones pueden ser secuestradas

• Incumplimiento de normativas como el RGPD

Solución:

• Usa un certificado SSL (Let's Encrypt o tu proveedor de hosting)

• Configura redirecciones de HTTP a HTTPS

• Actualiza URLs en conf/conf.php si es necesario

HTTPS no solo protege tus datos, también aumenta la confianza del usuario.

Error nº 5: No tener una estrategia de copias de seguridad

Muchos usuarios piensan en los backups demasiado tarde. Una caída del servidor, una eliminación accidental o un fallo pueden destruir toda tu base de datos ERP.

Estrategia de copias de seguridad:

• Usa el módulo de copias de seguridad para exportaciones periódicas

• Programa backups automáticos de la base de datos y documents/ (cron o script)

• Almacena las copias en un lugar externo (nube o servidor independiente)

• Prueba regularmente tus backups restaurando datos

Dolibarr también admite herramientas CLI y extensiones de terceros para la gestión de backups.

Error nº 6: Permisos incorrectos en archivos y carpetas

Los permisos incorrectos pueden causar vulnerabilidades o impedir el funcionamiento del sistema.

Directorios críticos:

• /conf/ – archivos de configuración

• /documents/ – archivos del usuario (facturas, logotipos, etc.)

Errores comunes:

• Asignar permisos 777 a carpetas

• Dejar conf/conf.php accesible públicamente

• Propietario incorrecto (por ejemplo, no ser www-data)

Solución:

• Usa 755 para carpetas y 644 para archivos

• Asegúrate de que el propietario sea el usuario del servidor web

• Si es posible, mueve documents/ fuera del directorio web público

Error nº 7: Mala gestión de módulos y actualizaciones

La modularidad es una fortaleza de Dolibarr, pero mal administrada puede causar inestabilidad.

Riesgos:

• Activar muchos módulos sin comprender las dependencias

• Usar módulos antiguos o incompatibles

• Ignorar actualizaciones de seguridad

Solución:

• Activa solo los módulos que realmente necesitas

• Distingue entre módulos oficiales, de Dolistore o personalizados

• Haz un backup antes de cada actualización

• Revisa los changelogs y foros antes de actualizar

• Prueba actualizaciones en un entorno de pruebas primero

Actualiza también los temas y módulos personalizados junto con el núcleo de Dolibarr.

Bonus: Utiliza Docker para una instalación limpia

Si tienes conocimientos técnicos básicos, puedes instalar Dolibarr con Docker – moderno, seguro y portátil.

Ventajas de Docker:

• Entornos aislados

• Implementación rápida y reproducible

• Contenedores listos para Dolibarr, base de datos y servidor web

Puedes usar un docker-compose.yml para definir toda la instalación.

Lista final antes de lanzar

Resumen rápido para revisar:

1. ✅ El servidor cumple con los requisitos técnicos

2. ✅ Base de datos y usuario dedicados con contraseña segura

3. ✅ Carpeta /install/ eliminada

4. ✅ HTTPS activo y obligatorio

5. ✅ Copias de seguridad automáticas configuradas

6. ✅ Permisos adecuados en archivos y carpetas

7. ✅ Solo los módulos necesarios están activos

8. ✅ Actualizaciones probadas en entorno de staging

Conclusión

Instalar Dolibarr no es complicado – pero es fácil pasar por alto pasos críticos. Ya sea para una startup, una ONG o una PYME, esta guía te proporciona una base sólida.

Si evitas estos 7 errores comunes, ahorrarás tiempo, protegerás tus datos y asegurarás que tu ERP sea seguro, eficiente y preparado para crecer. Cuida la instalación desde el principio – tu sistema te lo agradecerá.