Dolibarr „config file not correctly defined“: Ursachen

Die Meldung „Dolibarr config file content seems to be not correctly defined“ Ursache für Ursache auf Dolibarr 24 nachgestellt: was die Klammer verrät, Serverumzug, fehlende Datei, geplante Aufgaben und warum ein erneutes /install auf einer bestehenden Instanz nicht harmlos ist.

Sie öffnen Dolibarr und die Seite zeigt nur zwei englische Zeilen:

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

Diese Meldung bedeutet nicht, dass die Datenbank beschädigt ist. Sie sagt nur eines: Dolibarr hat seine Konfigurationsdatei conf/conf.php gefunden, findet nach dem Lesen aber seinen eigenen Code nicht. Alles Weitere hängt davon ab, was in der Klammer steht.

Jeder Fall unten wurde am 18. Oktober 2026 auf einer neuen Installation von Dolibarr 24.0.2 gezielt ausgelöst.

Lesen Sie die Klammer

Die Meldung stammt aus einer einzigen Prüfung in filefunc.inc.php: Dolibarr liest die Zeile $dolibarr_main_document_root aus conf.php und prüft, ob dort eine Datei core/lib/functions.lib.php existiert. Daraus ergeben sich zwei Varianten der Meldung.

Klammer	Bedeutung	Gefundene Ursachen
`… can't be unknown)`	`conf.php` nennt keinen Pfad	leere Datei; Zeile gelöscht oder auskommentiert; auf der Kommandozeile: Datei für das ausführende Konto nicht lesbar
`(file /ein/pfad/… not found)`	Pfad angegeben, aber der Code liegt dort nicht	Dolibarr wurde verschoben (Umzug, Hoster benennt Ordner um); oder die Datei ist verschwunden

In älteren Versionen kann die Klammer fehlen: Die Diagnose bleibt gleich, Sie müssen nur conf.php öffnen, um zu wissen, welcher Fall vorliegt.

Fall 1: „can’t be unknown“, die Datei nennt keinen Pfad

Öffnen Sie htdocs/conf/conf.php (laut Code legen die Debian- und Red-Hat-Pakete sie unter /etc/dolibarr/conf.php ab).

Die Datei ist leer, direkt nach der Installation: Das ist die Situation der Threads 49980 und 51134 im französischen Forum (im zweiten mit dem .deb-Paket). Nur in diesem Fall tun Sie, was die Meldung sagt: Öffnen Sie die Adresse von Dolibarr mit /install dahinter (zum Beispiel http://localhost/dolibarr/install) und folgen Sie dem Assistenten. Das hat beiden Personen weitergeholfen. War Dolibarr schon in Gebrauch, bedeutet eine leere Datei, dass sie überschrieben wurde: Nehmen Sie die aus Ihrer letzten Sicherung (und lesen Sie den Abschnitt zu /install, bevor Sie den Assistenten erneut starten).
Die Datei ist gefüllt, aber die Zeile $dolibarr_main_document_root= fehlt oder beginnt mit //: Fügen Sie sie wieder ein, mit dem Ordner, der index.php und den Ordner core enthält. Wir haben den Fehler ausgelöst, indem wir einfach // vor diese Zeile gesetzt haben.

Fall 2: „file … not found“, vergleichen Sie den Pfad

Sehen Sie sich den angezeigten Pfad an und dann den tatsächlichen Ordner von Dolibarr auf dem Server.

Die Meldung, wenn conf.php noch auf den alten Ordner zeigt

Der Pfad ist ein anderer: Dolibarr wurde verschoben, oder der Hoster hat seine Ordnerstruktur geändert (Threads 51071 beim Anbieter Free und 49565 nach einem Serverwechsel, französisches Forum). Korrigieren Sie die Zeilen in conf.php, die den alten Pfad enthalten:

$dolibarr_main_document_root='/neuer/pfad/htdocs';
$dolibarr_main_document_root_alt='/neuer/pfad/htdocs/custom';
$dolibarr_main_data_root='/neuer/pfad/documents';

Den richtigen Pfad ohne SSH-Zugang herausfinden: Öffnen Sie /install im Browser. Selbst wenn die Installation durch install.lock gesperrt ist, zeigt Dolibarr 24.0.2 dann eine Warnung mit beiden Pfaden: „You are running files from directory (/der/echte/pfad/) that differs from the directory already defined into the existing conf.php file“. Wir haben das mit gesetzter Sperre geprüft.

Auf Shared Hosting zeigt das PHP-Protokoll oft zusätzlich die Warnung open_basedir restriction in effect. File(/alter/pfad/…) is not within the allowed path(s): gleiche Ursache, gleiche Lösung. In unserem Test erschien diese Warnung nur im Serverprotokoll, nicht am Bildschirm.

Der Pfad stimmt: Dann fehlt die Datei core/lib/functions.lib.php. Wir haben das durch Löschen der Datei nachgestellt: Die Meldung zeigt dann den echten Pfad. Mögliche Ursachen: ein abgebrochenes Update oder FTP-Hochladen, oder ein Programm, das Dateien löscht. Im Thread 46065 des französischen Forums verschwand die Datei jeden Morgen; ein übereifriger Virenscanner wurde vermutet, ohne Gewissheit. Lösung: Spielen Sie die Dateien derselben Version von Dolibarr erneut ein (offizielles Archiv), ohne conf/conf.php und den Dokumentenordner anzurühren, und suchen Sie dann, was die Datei löscht.

Ein Schrägstrich am Ende des Pfads (/var/www/html/) ist kein Problem: Wir haben es getestet.

Was diese Meldung nicht auslöst

Zwei ähnliche Störungen sehen anders aus; das hilft, nicht an der falschen Stelle zu suchen:

conf.php fehlt oder ist für den Webserver nicht lesbar: keine Meldung, Dolibarr leitet auf /install um. Ist install.lock vorhanden, sehen Sie dann „Die Installations-/Upgrade-Seiten wurden aus Sicherheitsgründen deaktiviert“. Siehe install.lock und die Installationsseite.
Ein Tippfehler in conf.php (ein vergessenes Anführungszeichen nach einer Änderung): weiße Seite oder Fehler 500. Das PHP-Protokoll meldet PHP Parse error: syntax error … in …/conf/conf.php on line 16. Achtung, die genannte Zeile ist oft die nach dem Fehler: In unserem Test fehlte das Anführungszeichen in Zeile 15. Siehe Fehler 500 oder weiße Seite.

Soll man /install starten, wie die Meldung verlangt?

Bei einer neuen Installation ja. Bei einem Dolibarr, das schon genutzt wird, nein, nicht bevor die Ursache klar ist. Wir haben conf.php geleert, die Sperre entfernt und den Assistenten auf der bestehenden Datenbank mit denselben Datenbankeinstellungen erneut ausgeführt:

Die Daten waren noch da (der Test-Geschäftspartner, das Admin-Konto mit seinem alten Passwort: Der Assistent meldete nur, dass der Admin-Benutzer schon existiert);
aber der Assistent schrieb eine neue conf.php mit einem neuen Instanzschlüssel ($dolibarr_main_instance_unique_id). Daten, die Dolibarr mit diesem Schlüssel verschlüsselt, werden unlesbar: In unserem Test ließ sich das gespeicherte SMTP-Passwort nicht mehr entschlüsseln, was den E-Mail-Versand lahmlegt (siehe Dolibarr versendet keine E-Mails).

Den alten Schlüssel wieder in die neue conf.php einzutragen, machte alles wieder lesbar. Haben Sie den Assistenten schon erneut ausgeführt, holen Sie diese Zeile aus einer alten Kopie von conf.php (siehe Dolibarr sichern und wiederherstellen). Wir haben nur eine fast leere Testdatenbank geprüft: Bei einer echten machen Sie vorher unbedingt eine Sicherung.

Nach einem Umzug: Anmeldeseite ohne Formatierung

Ist der Pfad korrigiert, wartet auf alle, die den Hoster wechseln, eine zweite Falle: die Zeile $dolibarr_main_url_root. Enthielt die alte Adresse einen Unterordner (zum Beispiel https://alter-hoster/dolibarr/htdocs) und die neue nicht, erscheint die Anmeldeseite ganz ohne Formatierung, und nach der Anmeldung landet der Browser auf „Not Found“.

Anmeldeseite mit einer alten Stamm-URL

Tragen Sie in $dolibarr_main_url_root genau die Adresse ein, mit der Sie Dolibarr öffnen, ohne Schrägstrich am Ende. Bei einem reinen Domainwechsel ohne Unterordner haben wir kein Darstellungsproblem festgestellt, aktualisieren Sie die Zeile trotzdem.

Geplante Aufgaben zeigen den Fehler, nicht der Browser

Funktioniert die Website, kommt die Meldung aber per E-Mail oder im Cron-Protokoll, liegt es oft am Konto. Wir haben conf.php nur für den Eigentümer root lesbar gemacht: Unter dem Konto des Webservers (www-data) gab cron_run_jobs.php „can’t be unknown“ aus; als root lief es. Lassen Sie die Aufgabe unter dem Konto laufen, das conf.php lesen kann, meist dem des Webservers (siehe die Cron-Zeile in der Anleitung Dolibarr auf Ubuntu oder Debian installieren).

Es läuft immer noch nicht?

Bleibt die Meldung nach diesen Prüfungen bestehen oder haben Sie keine Kopie der alten conf.php, dann ist genau das die Diagnose für 90 €: eine Stunde an Ihrem Dolibarr, danach schriftlich die Ursache und was die Behebung kosten würde.