Dolibarr ist ein robustes und weit verbreitetes Open-Source-ERP- und CRM-System. Es wird aufgrund seiner Flexibilität, Benutzerfreundlichkeit und Anpassungsfähigkeit an unterschiedliche Geschäftsanforderungen geschätzt. Wie bei jeder komplexen Software können Benutzer jedoch gelegentlich auf Probleme stoßen – besonders beunruhigend ist es, wenn Dolibarr plötzlich nicht mehr funktioniert oder sich überhaupt nicht mehr öffnen lässt.

Unabhängig davon, ob Ihr Dolibarr lokal oder auf einem Remote-Server gehostet wird, kann eine leere Seite oder eine Fehlermeldung verschiedene Ursachen haben. In dieser ausführlichen Anleitung untersuchen wir die häufigsten Ursachen und bieten praktische Schritt-für-Schritt-Lösungen, mit denen Sie Ihr System wieder online bringen können.

Inhaltsverzeichnis

  1. Erste Einschätzung: Ist Dolibarr wirklich down?

  2. Webserver- und Dienststatusprüfung

  3. Weißer Bildschirm des Todes (WSOD)

  4. PHP-Fehler und Fehlkonfigurationen

  5. Datenbankverbindungsfehler

  6. Beschädigte oder fehlende Dateien

  7. Berechtigungs- und Eigentumsprobleme

  8. Falsch konfigurierte conf.php-Datei

  9. Probleme nach einem kürzlichen Update oder einer Migration

  10. Browserbezogene oder Cache-Probleme

  11. Fehlerprotokolle: Ihr bester Freund

  12. Verwenden des Entwicklermodus zum Debuggen

  13. Wiederherstellungsstrategien

  14. Vorsichtsmaßnahmen

  15. Abschließende Gedanken und Empfehlungen

1. Erste Einschätzung: Ist Dolibarr wirklich down?

Bevor Sie sich in die technische Fehlerbehebung stürzen, beginnen Sie mit einer kurzen Einschätzung:

  • Lädt die Seite überhaupt? Oder ist sie komplett leer?

  • Erhalten Sie einen bestimmten HTTP-Fehler (z. B. 403, 404, 500)?

  • Können Sie direkt auf die Datenbank zugreifen?

  • Sind Sie der einzige Benutzer, bei dem das Problem auftritt, oder betrifft es alle?

Das Verständnis des Kontexts hilft, das Problem einzugrenzen. Ein globaler Ausfall deutet auf serverseitige Probleme hin, während benutzerspezifische Probleme lokaler Natur sein können.

2. Webserver- und Servicestatusprüfung

Wenn Dolibarr selbst gehostet wird, besteht Ihr erster Schritt darin, zu überprüfen, ob der Webserver (Apache, Nginx usw.) und die zugehörigen Dienste ausgeführt werden.

sudo systemctl status apache2
sudo systemctl status nginx
sudo systemctl status mysql

Wenn einer dieser Dienste inaktiv ist oder ausgefallen ist, starten Sie ihn neu:

sudo systemctl restart apache2
sudo systemctl restart mysql

Stellen Sie sicher, dass auf Ihrem Server nicht zu viel Arbeitsspeicher oder Speicherplatz vorhanden ist, da dies zum Absturz dieser Dienste führen kann.

3. White Screen of Death (WSOD)

Ein leerer weißer Bildschirm ohne Fehlermeldungen wird oft als „White Screen of Death“ bezeichnet. In PHP-basierten Anwendungen wie Dolibarr signalisiert er in der Regel einen schwerwiegenden Fehler im Code.

So finden Sie die Grundursache:

  • Aktivieren Sie die Fehlerberichterstattung in conf.php:

$dolibarr_main_prod = 0;

  • Überprüfen Sie Webserver-Protokolle und PHP-Protokolle

Leere Bildschirme weisen fast immer auf fehlende Includes, Syntaxfehler oder ein fehlgeschlagenes Upgrade hin.

4. PHP-Fehler und Fehlkonfigurationen

Viele Dolibarr-Probleme entstehen durch PHP-Probleme, insbesondere nach Updates.

Zu den häufigsten PHP-bezogenen Problemen gehören:

  • Inkompatible PHP-Versionen

  • Deaktivierte Erweiterungen (wie pdo_mysql, gd, json)

  • Zu niedrige Speichergrenzen

Fixes:

  • Überprüfen Sie die Kompatibilität der PHP-Version mit Ihrer Dolibarr-Version

  • Nutzen Sie php -m um installierte Erweiterungen aufzulisten

  • Ändern php.ini So erhöhen Sie den Speicher:

memory_limit = 512M

Starten Sie den Server nach dem Vornehmen von Änderungen neu.

5. Datenbankverbindungsfehler

Dolibarr ist stark von seiner MySQL- oder PostgreSQL-Datenbank abhängig. Wenn keine Verbindung hergestellt werden kann, wird die Anwendung nicht geladen.

Symptome:

  • Leerer Bildschirm ohne Fehler

  • Meldung wie „Verbindung verweigert“ oder „Zugriff verweigert“

Was zu überprüfen:

  • conf.php enthält korrekte DB-Anmeldeinformationen

  • MySQL-Server läuft

  • Der Datenbankbenutzer verfügt über die erforderlichen Berechtigungen

Versuchen Sie, manuell über die Befehlszeile eine Verbindung herzustellen:

mysql -u dolibarruser -p dolibarrdb

6. Beschädigte oder fehlende Dateien

Updates, Serverabstürze oder Unterbrechungen bei der Dateiübertragung können Dateien beschädigen.

Überprüfen:

  • Vergleichen Sie Ihre aktuellen Dolibarr-Dateien mit einer sauberen Kopie

  • Suchen Sie nach teilweise hochgeladenen Dateien oder falschen Dateigrößen

Lösung:

  • Laden Sie eine saubere Kopie von Dolibarr erneut hoch (außer conf.php kombiniert mit einem nachhaltigen Materialprofil. /documents)

  • Einblick in das .htaccess und Modulordner

7. Probleme mit Berechtigungen und Eigentumsrechten

Falsche Dateiberechtigungen sind eine häufige Ursache für Probleme, insbesondere nach einer Migration oder einem manuellen Update.

Empfohlene Berechtigungen:

chown -R www-data:www-data /var/www/dolibarr
find /var/www/dolibarr -type f -exec chmod 644 {} \;
find /var/www/dolibarr -type d -exec chmod 755 {} \;

Passen Sie den Benutzer/die Gruppe basierend auf Ihrem Server-Setup an.

8. Falsch konfigurierte conf.php-Datei

Die conf.php Datei in /htdocs/conf/ ist kritisch. Wenn der Inhalt geändert oder gelöscht wird, wird Dolibarr nicht geladen.

Prüfen Auf:

  • Korrigieren Sie die Datenbankanmeldeinformationen

  • Richtige Pfade (insbesondere, wenn Sie Server verschoben haben)

  • Gültige PHP-Syntax (fehlende Semikolons usw.)

Bearbeiten Sie diese Datei immer mit einem Code-Editor, nicht mit einem Textverarbeitungsprogramm.

9. Probleme nach einem kürzlichen Update oder einer Migration

Viele Dolibarr-Fehler treten direkt nach einem Versionsupgrade oder einer Servermigration auf.

Ursachen:

  • Unvollständige Datei-Uploads

  • Übersprungene Schritte zum Datenbankupgrade

  • Modulinkompatibilitäten

Fix:

  • Gehe zu /install/ und schließen Sie den Upgrade-Assistenten ab

  • Führen Sie SQL-Upgrade-Skripte bei Bedarf manuell erneut aus

  • Verschieben Sie inkompatible Module aus dem custom/ Flyer

10. Browserbezogene oder Cache-Probleme

Manchmal funktioniert Dolibarr möglicherweise einwandfrei, aber Ihr Browser zeigt einen zwischengespeicherten Fehler an.

Solutions:

  • Löschen Sie den Browser-Cache

  • Verwenden Sie den Inkognito-Modus

  • Versuchen Sie, von einem anderen Browser oder Gerät aus darauf zuzugreifen

Sie können den Server-Cache auch leeren, wenn Sie einen Reverse-Proxy oder eine Caching-Ebene implementiert haben.

11. Fehlerprotokolle: Ihr bester Freund

Fehlerprotokolle enthalten oft die genaue Ursache des Problems. Überprüfen Sie:

  • Apache-Protokolle: /var/log/apache2/error.log

  • PHP-Protokolle: Abhängig von Ihrer php.ini Config

  • Dolibarr-Protokoll: /documents/dolibarr.log

Suchen Sie nach aktuellen Einträgen mit den Meldungen „Schwerwiegend“, „Fehler“ oder „Warnung“.

12. Verwenden des Entwicklermodus zum Debuggen

Rahmen $dolibarr_main_prod = 0; in Ihrem conf.php Die Datei zeigt PHP-Fehler direkt im Browser an und erleichtert so das Debuggen.

Verwenden Sie dies nur vorübergehend in einer sicheren Umgebung, nicht auf einem öffentlichen Server.

Sie können auch Debugging-Tools wie Xdebug installieren, um den Code bei Bedarf schrittweise durchzugehen.

13. Wiederherstellungsstrategien

Wenn Standardlösungen nicht funktionieren, ziehen Sie Folgendes in Betracht:

  • Wiederherstellen einer aktuellen Sicherung: Zuverlässigste Option, wenn Sie einen guten Schnappschuss haben

  • Richten Sie eine neue Dolibarr-Installation ein und migrieren Sie die Datenbank dorthin

  • Stellen Sie einen Fachmann ein wenn das Problem komplex und geschäftskritisch ist

Mit einem Reaktionsplan für Ausfallzeiten können Sie schnell handeln und die Auswirkungen minimieren.

14. Vorbeugende Maßnahmen

Verhindern Sie zukünftige Vorfälle durch:

  • Regelmäßiges Sichern von Dateien und Datenbanken

  • Verwenden der Versionskontrolle für benutzerdefinierte Module

  • Updates zunächst in einer Staging-Umgebung testen

  • Überwachen von Speicherplatz und Leistung

  • Beschränkung des Serverzugriffs auf vertrauenswürdiges Personal

Diese Gewohnheiten tragen wesentlich zur Aufrechterhaltung eines gesunden Dolibarr-Systems bei.

15. Abschließende Gedanken und Empfehlungen

Wenn Dolibarr nicht mehr funktioniert, kann es sich anfühlen, als wäre Ihr gesamtes Geschäftssystem eingefroren. Die meisten Ursachen lassen sich jedoch mit einem strukturierten Fehlerbehebungsprozess identifizieren und beheben.

Beginnen Sie mit den Grundlagen – Server- und Serviceprüfungen – und gehen Sie dann zu Konfigurationsdateien, Fehlerprotokollen und PHP-Einstellungen über. Achten Sie auf eine saubere, modulare und gut dokumentierte Installation.

Und das Wichtigste: Bereiten Sie sich auf das Unerwartete vor. Mit der richtigen Präventionsstrategie stellen Sie sicher, dass Dolibarr auch dann einsatzbereit bleibt, wenn Sie es am dringendsten benötigen.