Inhaltsverzeichnis

  1. Einführung

  2. Übersicht über die Installationsanforderungen von Dolibarr

  3. Problem 1: Leere Seite nach dem Starten des Installationsprogramms

  4. Problem 2: Inkompatibilität der PHP-Version

  5. Problem 3: Fehlende PHP-Erweiterungen

  6. Problem 4: Probleme mit den Dateiberechtigungen

  7. Problem 5: Datenbankverbindungsfehler

  8. Problem 6: Unvollständiger Installationsassistent

  9. Problem 7: install.lock nicht erstellt

  10. Problem 8: Die Datei Conf.php ist nicht beschreibbar

  11. Problem 9: Apache- oder Nginx-Konfigurationsfehler

  12. Problem 10: URL-Umschreibung und .htaccess-Probleme

  13. Problem 11: Zeitüberschreitungen während der Installation

  14. Problem 12: Fehler bei der Installation des Sprachpakets

  15. Problem 13: HTTPS- oder SSL-Fehler

  16. Problem 14: Probleme mit Shared-Hosting-Umgebungen

  17. Problem 15: Neuinstallationsschleife

  18. Tools zur Behebung von Installationsproblemen

  19. Best Practices zur Vermeidung von Installationsfehlern

  20. Fazit

1. Einleitung

Dolibarr ist eine robuste und flexible ERP/CRM-Lösung. Wie bei jeder webbasierten Anwendung kann der Installationsprozess jedoch manchmal durch Serverkonfiguration, fehlende Abhängigkeiten oder Fehler bei der Einrichtung beeinträchtigt werden. Dieser Artikel bietet eine detaillierte Analyse der häufigsten Installationsprobleme und praktische Lösungen.

2. Übersicht über die Dolibarr-Installationsanforderungen

Stellen Sie vor dem Beginn sicher, dass der Server die folgenden Anforderungen erfüllt:

  • PHP 7.4 bis 8.2

  • MySQL 5.7+ oder MariaDB 10+

  • Apache/Nginx mit aktiviertem mod_rewrite

  • Erforderliche PHP-Erweiterungen: pdo_mysql, gd, intl, zip, curl, json, mbstring, fileinfo

  • Beschreibbare Verzeichnisse: htdocs/conf/, documents/ und install/

Die Installation von Dolibarr umfasst das Hochladen des Pakets, das Ausführen des /install/ Skript, Konfigurieren der Datenbank und Abschließen des Setups.

3. Problem 1: Leere Seite nach dem Starten des Installationsprogramms

Symptome:

  • Navigieren zu /install/ ergibt einen weißen oder leeren Bildschirm.

Ursachen:

  • PHP-Fehler oder schwerwiegende Ausnahme.

Solutions:

  • Aktivieren Sie die Fehlerberichterstattung in php.ini: display_errors = On

  • Überprüfen Sie die Webserver-Protokolle (/var/log/apache2/error.log or /var/log/nginx/error.log)

  • Stellen Sie sicher, dass die erforderlichen PHP-Module installiert sind

  • Verwenden Sie eine andere PHP-Version, wenn die aktuelle fehlerhaft ist

4. Problem 2: Inkompatibilität der PHP-Version

Symptome:

  • Veraltete Warnungen oder Funktionsfehler.

Ursachen:

  • Verwendung einer nicht unterstützten PHP-Version.

Solutions:

  • Verwenden Sie PHP 7.4 bis 8.2, gemäß der Kompatibilitätstabelle von Dolibarr

  • Installieren Sie die richtige Version mit dem Paketmanager Ihres Servers oder mit Tools wie phpbrew or update-alternatives

  • Starten Sie den Webserver nach dem Wechsel der PHP-Version neu

5. Problem 3: Fehlende PHP-Erweiterungen

Symptome:

  • Das Installationsprogramm meldet fehlende Module (z. B. intl, curl).

Ursachen:

  • Erforderliche PHP-Erweiterungen nicht installiert oder nicht aktiviert.

Solutions:

  • Installieren Sie Erweiterungen über den Paketmanager: sudo apt install php-intl php-curl php-gd php-mbstring

  • Einblick in das phpinfo() zur Bestätigung

  • Starten Sie Apache oder Nginx nach Änderungen neu

6. Problem 4: Probleme mit den Dateiberechtigungen

Symptome:

  • Konfigurationsdatei nicht gespeichert

  • Uploads funktionieren nicht

Ursachen:

  • Falsche Schreibberechtigungen für erforderliche Ordner

Solutions:

  • Eigentumsrechte festlegen: chown -R www-data:www-data /var/www/html/dolibarr

  • Berechtigungen festlegen: chmod -R 755 /var/www/html/dolibarr

  • Stellen Sie sicher, dass SELinux oder AppArmor den Schreibzugriff nicht blockieren

7. Problem 5: Datenbankverbindungsfehler

Symptome:

  • „Verbindung zur Datenbank konnte nicht hergestellt werden“ während der Einrichtung

Ursachen:

  • Falscher Hostname, Benutzername oder Passwort

  • MySQL-Dienst läuft nicht

  • Dem Benutzer fehlen CREATE-Berechtigungen

Solutions:

  • Überprüfen Sie den MySQL-Dienst mit systemctl status mysql

  • Überprüfen Sie die Anmeldeinformationen im Dolibarr-Installationsprogramm

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

8. Problem 6: Unvollständiger Installationsassistent

Symptome:

  • Das Setup bleibt hängen oder lädt denselben Schritt neu

Ursachen:

  • PHP-Sitzungs- oder Cache-Problem

  • Browser- oder Server-Timeout

Solutions:

  • Löschen Sie die Browser-Cookies und starten Sie die Installation neu

  • Erhöhen Sie das PHP-Timeout in php.ini: max_execution_time = 120

  • Verwenden Sie einen anderen Browser

9. Problem 7: install.lock nicht erstellt

Symptome:

  • Das Installationsprogramm wird auch nach Abschluss der Installation ausgeführt

Ursachen:

  • Webserver-Benutzer hat keine Berechtigung zum Erstellen install.lock

Solutions:

  • Manuell erstellen /htdocs/install.lock

  • Berechtigungen festlegen: touch install.lock && chmod 644 install.lock

  • Bestätigen Sie, dass die Datei vom Webserver gelesen werden kann

10. Problem 8: Conf.php-Datei nicht beschreibbar

Symptome:

  • Fehler „conf.php kann nicht geschrieben werden“

Ursachen:

  • Datei während der Installation nicht beschreibbar

Solutions:

  • Stelle den conf.php zu beschreibbar: chmod 666 htdocs/conf/conf.php

  • Setzen Sie es nach der Installation wieder auf schreibgeschützt: chmod 444 conf.php

11. Problem 9: Apache- oder Nginx-Konfigurationsfehler

Symptome:

  • 403 Forbidden- oder 404 Not Found-Fehler

Ursachen:

  • Falsch konfigurierter virtueller Host oder fehlende Umschreibregeln

Solutions:

  • Überprüfen Sie die DocumentRoot- und Directory-Einstellungen in apache2.conf

  • Aktivieren Sie mod_rewrite: a2enmod rewrite

  • Speichern AllowOverride All zur Apache-Konfiguration

  • Stellen Sie für Nginx sicher, try_files $uri $uri/ /index.php?$query_string; verwendet wird

12. Problem 10: URL-Umschreibung und .htaccess-Probleme

Symptome:

  • Freundliche URLs funktionieren nicht

  • Menülinks defekt

Ursachen:

  • mod_rewrite nicht aktiviert oder .htaccess ignoriert

Solutions:

  • Aktivieren Sie Apaches mod_rewrite

  • Erlauben .htaccess überschreibt in Directory Config

  • Testen mit: http://yourdomain/dolibarr/admin/index.php (direkte URL)

13. Problem 11: Zeitüberschreitungen während der Installation

Symptome:

  • Der Installationsvorgang dauert zu lange und schlägt fehl

Ursachen:

  • Langsame Datenbank

  • PHP-Ausführungszeitüberschreitung

Solutions:

  • Steigern max_execution_time kombiniert mit einem nachhaltigen Materialprofil. memory_limit in php.ini

  • Serverlast überwachen und MySQL optimieren

14. Problem 12: Fehler bei der Installation des Sprachpakets

Symptome:

  • Die Sprachauswahl schlägt fehl oder es treten Fehler auf

Ursachen:

  • Probleme mit der Internetverbindung oder den Dateiberechtigungen

Solutions:

  • Laden Sie Pakete manuell vom Dolibarr-Übersetzungsportal herunter

  • Extrahieren Sie sie in /htdocs/langs/

  • Überprüfen Sie die korrekten Ordnernamen (z. B. fr_FR, en_US)

15. Problem 13: HTTPS- oder SSL-Fehler

Symptome:

  • Browser warnt vor unsicherer Verbindung

  • Einige Links funktionieren unter HTTPS nicht

Ursachen:

  • SSL nicht richtig konfiguriert

Solutions:

  • SSL-Zertifikat installieren (Let’s Encrypt usw.)

  • Aktualisieren Sie Dolibarrs URL in conf.php auf https://

  • Erzwinge HTTPS-Umleitung in .htaccess

16. Problem 14: Probleme mit Shared-Hosting-Umgebungen

Symptome:

  • Eingeschränkte PHP-Version oder Erweiterungen

  • Berechtigungsfehler

Ursachen:

  • Einschränkungen des Hosting-Anbieters

Solutions:

  • Wählen Sie einen Anbieter mit Unterstützung für benutzerdefinierte PHP-Einstellungen

  • Nutzen Sie .user.ini or .htaccess um PHP-Werte festzulegen

  • Entscheiden Sie sich für einen VPS oder Cloud-Server für die volle Kontrolle

17. Problem 15: Neuinstallationsschleife

Symptome:

  • Der Installationsassistent wird nach Abschluss neu gestartet

Ursachen:

  • Sitzung verloren oder install.lock fehlt

Solutions:

  • Browser-Cookies löschen

  • Verify install.lock existiert und ist lesbar

  • Überprüfen Sie den Dateisystempfad in der Konfiguration noch einmal

18. Tools zur Behebung von Installationsproblemen

  • phpinfo() für Details zur PHP-Umgebung

  • Apache/Nginx-Fehlerprotokolle

  • MySQL-Protokolle: /var/log/mysql/error.log

  • Browser-Entwicklertools (Registerkarten „Konsole“ und „Netzwerk“)

19. Best Practices zur Vermeidung von Installationsfehlern

  • Lesen Sie die Installationsanleitung von Dolibarr sorgfältig durch

  • Verwenden Sie Staging-Server zum Testen

  • Halten Sie Systempakete auf dem neuesten Stand

  • Überwachen von Serverressourcen

  • Dokumentieren Sie Ihre Installationsschritte und Konfigurationen

20. Fazit

Die Installation von Dolibarr ist unkompliziert, sofern die Systemanforderungen und Berechtigungen erfüllt sind. Das Übersehen kleiner Konfigurationen kann jedoch zu frustrierenden Fehlern führen. Dieser Leitfaden bietet umfassende Lösungen für die häufigsten Installationsprobleme, damit Sie ohne Verzögerungen von der Einrichtung zur produktiven Nutzung übergehen können. Richtige Planung, Berechtigungen und Systemkompatibilität sind die Grundpfeiler einer erfolgreichen Bereitstellung.