«Dolibarr config file content seems to be not correctly defined»

Abre Dolibarr y la página solo contiene dos líneas en inglés:

Error: Dolibarr config file content seems to be not correctly defined (…).
Please run dolibarr setup by calling page /install.

Este mensaje no dice que la base de datos esté dañada. Dice una sola cosa: Dolibarr ha encontrado su archivo de configuración conf/conf.php, pero al leerlo no encuentra su propio código. Todo lo demás depende de lo que está escrito entre paréntesis.

Cada caso de abajo se provocó el 18 de octubre de 2026 en una instalación nueva de Dolibarr 24.0.2.

Lea el paréntesis

El mensaje viene de una sola comprobación, en filefunc.inc.php: Dolibarr lee la línea $dolibarr_main_document_root de conf.php y comprueba que existe un archivo core/lib/functions.lib.php en ese lugar. De ahí salen dos versiones del mensaje.

En las versiones más antiguas puede faltar el paréntesis: el diagnóstico de abajo sigue siendo el mismo, simplemente hay que abrir conf.php para saber en qué caso está.

Caso 1: «can’t be unknown», el archivo no da ninguna ruta

Abra htdocs/conf/conf.php (según el código, los paquetes Debian y Red Hat lo colocan en /etc/dolibarr/conf.php).

• El archivo está vacío, justo después de la instalación: es la situación de los hilos 49980 y 51134 del foro francés de Dolibarr (el segundo, con el paquete .deb). Solo en este caso, haga lo que dice el mensaje: abra la dirección de Dolibarr seguida de /install (por ejemplo http://localhost/dolibarr/install) y siga el asistente. Es lo que desbloqueó a esas dos personas. Si Dolibarr ya se usaba, un archivo vacío significa que se ha sobrescrito: recupere el de su última copia de seguridad (y lea la sección sobre /install antes de relanzar el asistente).
• El archivo tiene contenido, pero falta la línea $dolibarr_main_document_root= o empieza por //: vuelva a ponerla, con la carpeta que contiene index.php y la carpeta core. Provocamos el error simplemente añadiendo // delante de esa línea.

Caso 2: «file … not found», compare la ruta

Mire la ruta que aparece y luego la carpeta real de Dolibarr en el servidor.

La ruta es distinta: Dolibarr se ha movido, o el proveedor de alojamiento ha cambiado la organización de sus carpetas (hilos 51071 en el proveedor francés Free, 49565 tras un cambio de servidor). Corrija las líneas de conf.php que contienen la ruta antigua:

$dolibarr_main_document_root='/nueva/ruta/htdocs';
$dolibarr_main_document_root_alt='/nueva/ruta/htdocs/custom';
$dolibarr_main_data_root='/nueva/ruta/documents';

Para conocer la ruta correcta sin acceso SSH: abra /install en el navegador. Incluso cuando la instalación está bloqueada por install.lock, Dolibarr 24.0.2 muestra entonces un aviso que da las dos rutas: «You are running files from directory (/la/ruta/real/) that differs from the directory already defined into the existing conf.php file». Lo comprobamos con el bloqueo puesto.

En un alojamiento compartido, el registro de PHP muestra a menudo además un aviso open_basedir restriction in effect. File(/ruta/antigua/…) is not within the allowed path(s): misma causa, misma corrección. En nuestra prueba, este aviso solo aparecía en el registro del servidor, no en pantalla.

La ruta es la correcta: lo que falta es el archivo core/lib/functions.lib.php. Lo reprodujimos borrándolo: el mensaje muestra entonces la ruta real. Causas posibles: una actualización o una subida por FTP interrumpida, o una herramienta que borra archivos. En el hilo 46065, el archivo desaparecía cada mañana y se sospechó de un antivirus demasiado celoso, sin certeza. Corrección: vuelva a copiar los archivos de la misma versión de Dolibarr (archivo oficial), sin tocar conf/conf.php ni la carpeta de documentos, y luego busque qué borra el archivo.

Si ocurrió durante una actualización, ponga primero Dolibarr en marcha con su versión anterior. Antes de volver a intentar la actualización, nuestro módulo gratuito Listo para la actualización lee el código de sus módulos externos frente a la versión de destino, y comprueba PHP y la base de datos, sin modificar nada. El método completo está en Actualizar Dolibarr sin romper nada.

Una barra final en la ruta (/var/www/html/) no causa ningún problema: la probamos.

Lo que no da este mensaje

Dos averías parecidas se muestran de otra manera; conviene saberlo para no buscar en el sitio equivocado:

• conf.php ausente o ilegible para el servidor web: no hay mensaje, Dolibarr redirige a /install. Si install.lock existe, verá entonces «Las páginas de instalación/actualización se han deshabilitado por seguridad» (en una interfaz en español). Vea install.lock and the install page (en inglés).
• Una errata en conf.php (una comilla olvidada tras una modificación): página en blanco o error 500. El registro de PHP indica PHP Parse error: syntax error … in …/conf/conf.php on line 16. Cuidado: la línea citada suele ser la siguiente al error; en nuestra prueba, la comilla faltaba en la línea 15. Vea Dolibarr error 500 or blank page (en inglés).

¿Hay que lanzar /install, como pide el mensaje?

Para una instalación nueva, sí. Para un Dolibarr que ya se usa, no, no antes de haber entendido la causa. Vaciamos conf.php, quitamos el bloqueo y relanzamos el asistente sobre la base de datos existente, con los mismos parámetros de conexión:

• los datos seguían ahí (el tercero de prueba, la cuenta admin con su antigua contraseña: el asistente solo avisó de que el usuario admin ya existía);
• pero el asistente escribió un conf.php nuevo, con una nueva clave de instancia ($dolibarr_main_instance_unique_id). Los datos que Dolibarr cifra con esa clave se vuelven ilegibles: en nuestra prueba, la contraseña SMTP guardada ya no se descifraba, lo que rompe el envío de correos (vea Dolibarr does not send emails, en inglés).

Volver a poner la clave antigua en el nuevo conf.php hizo que todo volviera a ser legible. Si ya ha relanzado el asistente, recupere esa línea de una copia antigua de conf.php (vea Back up and restore Dolibarr, en inglés). Solo probamos una base de datos de prueba casi vacía: con una base real, haga una copia de seguridad antes que nada.

Tras un traslado: la página de inicio de sesión sin estilos

Una vez corregida la ruta, una segunda trampa espera a quien cambia de proveedor de alojamiento: la línea $dolibarr_main_url_root. Si la dirección antigua contenía una subcarpeta (por ejemplo https://antiguo-proveedor/dolibarr/htdocs) y la nueva no, la página de inicio de sesión aparece sin ningún estilo, y tras iniciar sesión el navegador llega a «Not Found».

Ponga en $dolibarr_main_url_root la dirección exacta que escribe para abrir Dolibarr, sin barra final. Con un simple cambio de nombre de dominio, sin subcarpeta, no vimos ningún problema de visualización, pero actualícela de todos modos.

Las tareas programadas muestran el error, el navegador no

Si el sitio funciona pero el mensaje llega por correo o aparece en el registro del cron, suele ser una cuestión de cuenta. Dejamos conf.php legible solo por su propietario root: lanzado con la cuenta del servidor web (www-data), cron_run_jobs.php mostraba «can’t be unknown»; lanzado como root, funcionaba. Haga que la tarea se ejecute con la cuenta que puede leer conf.php, en general la del servidor web (vea la línea de cron de la guía Install Dolibarr on Ubuntu or Debian, en inglés).

Si no vuelve a arrancar

Si el mensaje persiste tras estas comprobaciones, o si no tiene copia del antiguo conf.php, el diagnóstico de 90 € (servicio en español, inglés, francés o alemán) consiste precisamente en revisar su instancia con usted durante una hora, y en entregarle por escrito la causa y lo que costaría la corrección.