Índice
-
Introducción
-
Descripción general de los requisitos de instalación de Dolibarr
-
Problema 1: Página en blanco después de iniciar el instalador
-
Problema 2: Incompatibilidad de la versión PHP
-
Problema 3: Extensiones PHP faltantes
-
Problema 4: Problemas con los permisos de archivos
-
Problema 5: Errores de conexión a la base de datos
-
Problema 6: Asistente de instalación incompleto
-
Problema 7: install.lock no creado
-
Problema 8: El archivo Conf.php no se puede escribir
-
Problema 9: Errores de configuración de Apache o Nginx
-
Número 10: Reescritura de URL y problemas con .htaccess
-
Problema 11: Tiempos de espera durante la instalación
-
Problema 12: Errores en la instalación de paquetes de idioma
-
Problema 13: Errores de HTTPS o SSL
-
Número 14: Problemas con entornos de alojamiento compartido
-
Número 15: Bucle de reinstalación
-
Herramientas para ayudar a solucionar problemas de instalación
-
Mejores prácticas para prevenir errores de instalación
-
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/, yinstall/
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.logor/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
phpbreworupdate-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.phppara 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 Alla 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_rewriteno habilitado o.htaccessignorado
Soluciones:
-
Habilitar Apache
mod_rewrite -
Permitir
.htaccessanulaciones enDirectoryconfig -
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_timeymemory_limitinphp.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.inior.htaccesspara 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.lockexiste 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.
