Índice

  1. Introducción

  2. Descripción general de los requisitos de instalación de Dolibarr

  3. Problema 1: Página en blanco después de iniciar el instalador

  4. Problema 2: Incompatibilidad de la versión PHP

  5. Problema 3: Extensiones PHP faltantes

  6. Problema 4: Problemas con los permisos de archivos

  7. Problema 5: Errores de conexión a la base de datos

  8. Problema 6: Asistente de instalación incompleto

  9. Problema 7: install.lock no creado

  10. Problema 8: El archivo Conf.php no se puede escribir

  11. Problema 9: Errores de configuración de Apache o Nginx

  12. Número 10: Reescritura de URL y problemas con .htaccess

  13. Problema 11: Tiempos de espera durante la instalación

  14. Problema 12: Errores en la instalación de paquetes de idioma

  15. Problema 13: Errores de HTTPS o SSL

  16. Número 14: Problemas con entornos de alojamiento compartido

  17. Número 15: Bucle de reinstalación

  18. Herramientas para ayudar a solucionar problemas de instalación

  19. Mejores prácticas para prevenir errores de instalación

  20. Conclusión


1. Introducción

Dolibarr es una solución ERP/CRM robusta y flexible. Sin embargo, como cualquier aplicación web, su instalación puede verse obstaculizada por la configuración del servidor, la falta de dependencias o errores durante la configuración. Este artículo presenta un análisis detallado de los problemas de instalación más comunes que enfrentan los usuarios y ofrece soluciones prácticas.


2. Descripción general de los requisitos de instalación de Dolibarr

Antes de comenzar, asegúrese de que el servidor cumpla estos requisitos:

  • PHP 7.4 a 8.2

  • MySQL 5.7+ o MariaDB 10+

  • Apache/Nginx con mod_rewrite habilitado

  • Extensiones PHP requeridas: pdo_mysql, gd, intl, zip, curl, json, mbstring, fileinfo

  • Directorios grabables: htdocs/conf/, documents/, y install/

La instalación de Dolibarr implica cargar el paquete, ejecutar el /install/ script, configurando la base de datos y finalizando la configuración.


3. Problema 1: Página en blanco después de iniciar el instalador

Sintomas:

  • Navegando a /install/ Produce una pantalla blanca o en blanco.

Causas:

  • Error de PHP o excepción fatal.

Soluciones:

  • Habilitar informes de errores en php.ini: display_errors = On

  • Comprobar los registros del servidor web (/var/log/apache2/error.log or /var/log/nginx/error.log)

  • Asegúrese de que los módulos PHP necesarios estén instalados

  • Utilice una versión diferente de PHP si la actual tiene errores


4. Problema 2: Incompatibilidad de la versión PHP

Sintomas:

  • Advertencias obsoletas o errores de funciones.

Causas:

  • Utilizando una versión de PHP no compatible.

Soluciones:

  • Utilice PHP 7.4 a 8.2, según la tabla de compatibilidad de Dolibarr

  • Instale la versión adecuada utilizando el administrador de paquetes de su servidor o herramientas como phpbrew or update-alternatives

  • Reiniciar el servidor web después de cambiar la versión de PHP


5. Problema 3: Extensiones PHP faltantes

Sintomas:

  • El instalador informa que faltan módulos (por ejemplo, intl, curl).

Causas:

  • Extensiones PHP requeridas no instaladas o no habilitadas.

Soluciones:

  • Instalar extensiones a través del administrador de paquetes: sudo apt install php-intl php-curl php-gd php-mbstring

  • Comprobar phpinfo() para confirmacion

  • Reiniciar Apache o Nginx después de los cambios


6. Problema 4: Problemas con los permisos de archivos

Sintomas:

  • Archivo de configuración no guardado

  • Las subidas no funcionan

Causas:

  • Permisos de escritura incorrectos en las carpetas requeridas

Soluciones:

  • Establecer propiedad: chown -R www-data:www-data /var/www/html/dolibarr

  • Establecer permisos: chmod -R 755 /var/www/html/dolibarr

  • Asegúrese de que SELinux o AppArmor no estén bloqueando el acceso de escritura


7. Problema 5: Errores de conexión a la base de datos

Sintomas:

  • “No se pudo conectar a la base de datos” durante la configuración

Causas:

  • Nombre de host, nombre de usuario o contraseña incorrectos

  • El servicio MySQL no se está ejecutando

  • El usuario carece de privilegios CREATE

Soluciones:

  • Verificar el servicio MySQL con systemctl status mysql

  • Comprobar credenciales en el instalador de Dolibarr

  • Otorgar privilegios: GRANT ALL ON dolibarr.* TO 'user'@'localhost' IDENTIFIED BY 'password';


8. Problema 6: Asistente de instalación incompleto

Sintomas:

  • La configuración se bloquea o vuelve a cargar el mismo paso

Causas:

  • Problema de sesión o caché de PHP

  • Tiempo de espera del navegador o del servidor

Soluciones:

  • Borrar las cookies del navegador y reiniciar la instalación

  • Aumentar el tiempo de espera de PHP en php.ini: max_execution_time = 120

  • Usa un navegador diferente


9. Problema 7: install.lock no creado

Sintomas:

  • El instalador se ejecuta incluso después de completarse la instalación

Causas:

  • El usuario del servidor web no tiene permiso para crear install.lock

Soluciones:

  • Crear manualmente /htdocs/install.lock

  • Establecer permisos: touch install.lock && chmod 644 install.lock

  • Confirmar que el servidor web pueda leer el archivo


10. Problema 8: El archivo Conf.php no se puede escribir

Sintomas:

  • Error “no se puede escribir conf.php”

Causas:

  • El archivo no se puede escribir durante la configuración

Soluciones:

  • Establecer conf.php para escribir: chmod 666 htdocs/conf/conf.php

  • Después de la instalación, configúrelo nuevamente como de solo lectura: chmod 444 conf.php


11. Problema 9: Errores de configuración de Apache o Nginx

Sintomas:

  • Errores 403 Prohibido o 404 No encontrado

Causas:

  • Host virtual mal configurado o reglas de reescritura faltantes

Soluciones:

  • Verifique la configuración de DocumentRoot y Directory en apache2.conf

  • Habilitar mod_rewrite: a2enmod rewrite

  • Agregar AllowOverride All a la configuración de Apache

  • Para Nginx, asegúrese try_files $uri $uri/ /index.php?$query_string; se utiliza


12. Problema 10: Reescritura de URL y problemas con .htaccess

Sintomas:

  • Las URL amigables no funcionan

  • Enlaces del menú rotos

Causas:

  • mod_rewrite no habilitado o .htaccess ignorado

Soluciones:

  • Habilitar Apache mod_rewrite

  • Permitir .htaccess anulaciones en Directory config

  • Prueba con: http://yourdomain/dolibarr/admin/index.php (URL directa)


13. Problema 11: Tiempos de espera durante la instalación

Sintomas:

  • El proceso de instalación tarda demasiado y falla

Causas:

  • Base de datos lenta

  • Tiempo de espera de ejecución de PHP

Soluciones:

  • Aumentar max_execution_time y memory_limit in php.ini

  • Supervisar la carga del servidor y optimizar MySQL


14. Problema 12: Errores en la instalación de paquetes de idioma

Sintomas:

  • La selección del idioma falla o aparecen errores

Causas:

  • Problemas de conectividad a Internet o permisos de archivos

Soluciones:

  • Descargar paquetes manualmente desde el portal de traducción de Dolibarr

  • Extraerlos en /htdocs/langs/

  • Verifique que los nombres de carpeta sean correctos (por ejemplo, fr_FR, en_US)


15. Problema 13: Errores de HTTPS o SSL

Sintomas:

  • El navegador advierte sobre una conexión insegura

  • Algunos enlaces no funcionan bajo HTTPS

Causas:

  • SSL no configurado correctamente

Soluciones:

  • Instalar certificado SSL (Let's Encrypt, etc.)

  • Actualice la URL de Dolibarr en conf.php a https://

  • Forzar la redirección HTTPS en .htaccess


16. Problema 14: Problemas con los entornos de alojamiento compartido

Sintomas:

  • Versión o extensiones de PHP limitadas

  • Errores de permisos

Causas:

  • Restricciones del proveedor de alojamiento

Soluciones:

  • Elija un proveedor con soporte para configuraciones PHP personalizadas

  • Usar .user.ini or .htaccess para establecer valores PHP

  • Opte por un VPS o un servidor en la nube para tener control total


17. Número 15: Bucle de reinstalación

Sintomas:

  • El asistente de instalación se reinicia después de finalizar

Causas:

  • Sesión perdida o falta install.lock

Soluciones:

  • Borrar cookies del navegador

  • Verificar install.lock existe y es legible

  • Verifique nuevamente la ruta del sistema de archivos en la configuración


18. Herramientas para ayudar a solucionar problemas de instalación

  • phpinfo() para detalles del entorno PHP

  • Registros de errores de Apache/Nginx

  • Registros de MySQL: /var/log/mysql/error.log

  • Herramientas para desarrolladores de navegadores (pestañas Consola y Red)


19. Mejores prácticas para prevenir errores de instalación

  • Lea atentamente la guía de instalación de Dolibarr

  • Utilice servidores de prueba para realizar pruebas

  • Mantenga los paquetes del sistema actualizados

  • Supervisar los recursos del servidor

  • Documente los pasos de instalación y las configuraciones


20. Conclusión

Instalar Dolibarr es un proceso sencillo si se cumplen los requisitos y permisos del sistema. Sin embargo, pasar por alto pequeñas configuraciones puede provocar errores frustrantes. Esta guía ofrece soluciones integrales a los problemas de instalación más comunes para que pueda pasar de la configuración a la productividad sin demoras. Una planificación adecuada, los permisos y la compatibilidad del sistema son fundamentales para una implementación exitosa.