Inhaltsverzeichnis

  1. Einführung

  2. Warum Dolibarr auf cPanel installieren?

  3. Voraussetzungen vor der Installation

  4. Schritt 1: Herunterladen des neuesten Dolibarr-Pakets

  5. Schritt 2: Hochladen von Dolibarr auf Ihr cPanel-Konto

  6. Schritt 3: Erstellen einer MySQL-Datenbank über cPanel

  7. Schritt 4: Festlegen der richtigen Dateiberechtigungen

  8. Schritt 5: Ausführen des Dolibarr-Installationsprogramms

  9. Schritt 6: Konfiguration nach der Installation

  10. Schritt 7: Sichern Ihrer Dolibarr-Instanz

  11. Schritt 8: Installieren zusätzlicher Module

  12. Schritt 9: Automatisieren von Backups und Updates

  13. Häufige Fehler und deren Behebung

  14. Abschließende Gedanken

1. Einleitung

Dolibarr ERP & CRM ist eine webbasierte Open-Source-Softwaresuite, die Unternehmen bei der Verwaltung aller Bereiche unterstützt – von Rechnungsstellung und Buchhaltung über Lagerverwaltung bis hin zu Personalwesen und Kundenbeziehungen. Sie wird besonders für ihren modularen Aufbau, ihre Benutzerfreundlichkeit und ihre Anpassungsfähigkeit an KMU, Freiberufler und NGOs geschätzt.

Wenn Sie Dolibarr installieren möchten auf CPanel hosting– eine der gängigsten und zugänglichsten Arten von Webhosting-Plattformen – dieser Leitfaden führt Sie in klaren, nicht-technischen Begriffen durch jeden Schritt des Prozesses.

Dieses Tutorial setzt voraus keine Entwicklerkenntnisse ist aber umfassend genug, um fortgeschrittenere Benutzer zu unterstützen, die ihre Dolibarr-Bereitstellung optimieren und sichern möchten.

2. Warum Dolibarr auf cPanel installieren?

cPanel ist ein weit verbreitetes Webhosting-Kontrollpanel, das die Serververwaltung über eine webbasierte Oberfläche vereinfacht. Es wird häufig von Shared-Hosting-Anbietern angeboten und enthält integrierte Tools für Dateiverwaltung, Datenbankerstellung, Domänenkontrolle und Softwarebereitstellung.

Vorteile der Verwendung von cPanel für Dolibarr:

  • Keine Kommandozeilenkenntnisse erforderlich

  • Einfacher Datei-Upload und Datenbank-Setup

  • Erschwingliche Hosting-Pläne

  • Zentralisierter Zugriff auf E-Mails, Backups und Domänen

  • Kompatibilität mit PHP und MySQL (Dolibarrs Kerntechnologien)

Die Installation von Dolibarr auf cPanel ist eine ausgezeichnete Wahl für Startups, kleine Unternehmen und Berater, die ihr ERP-System kostengünstig und zuverlässig hosten möchten, ohne einen VPS zu mieten oder einen Cloud-Server zu verwalten.

3. Voraussetzungen vor der Installation

Bevor Sie beginnen, benötigen Sie Folgendes:

  • Zugriff auf ein cPanel-Hosting-Konto

  • PHP-Version 7.4 oder höher (Dolibarr 15+ erfordert PHP 7.4+, neuere Versionen erfordern PHP 8.0+)

  • MySQL- oder MariaDB-Datenbankunterstützung

  • Dateimanager oder FTP-Zugriff

  • Grundlegendes Verständnis der Verwendung von cPanel-Tools

Empfohlene PHP-Erweiterungen:

Stellen Sie sicher, dass auf Ihrem cPanel-Server diese PHP-Erweiterungen aktiviert sind:

  • gd

  • mbstring

  • curl

  • intl

  • zip

  • pdo_mysql

  • xml

  • json

  • fileinfo

Sie können diese überprüfen und aktivieren über cPanel > PHP-Version auswählen > Erweiterungen (variiert je nach Host).

4. Schritt 1: Herunterladen des neuesten Dolibarr-Pakets

Laden Sie zunächst die neueste stabile Version von Dolibarr von der offiziellen Website herunter:

👉 https://www.dolibarr.org/downloads/

Wähle die „.zip“-Archiv zur Installation auf cPanel.

Speichern Sie die Datei auf Ihrem Computer.

Tipp: Verwenden Sie immer die offizielle Quelle, um beschädigte oder schädliche Dateien zu vermeiden.

5. Schritt 2: Hochladen von Dolibarr auf Ihr cPanel-Konto

Option 1: Verwenden des Dateimanagers

  1. Melden Sie sich bei Ihrem cPanel-Dashboard an.

  2. Navigieren Datei-Manager.

  3. Gehen Sie zu dem Ordner, in dem Dolibarr installiert werden soll (normalerweise public_html oder ein Unterordner wie public_html/erp/).

  4. Klicke HochladenWählen Sie die .zip die heruntergeladene Datei.

  5. Klicken Sie nach dem Hochladen mit der rechten Maustaste auf die ZIP-Datei und wählen Sie Extrahieren.

Dadurch wird ein Verzeichnis erstellt (z. B. dolibarr-xx.x.x). Sie können diesen Ordner in etwas Klareres umbenennen, wie dolibarr or erp.

Option 2: Verwenden von FTP (FileZilla)

Wenn Sie FTP bevorzugen, stellen Sie eine Verbindung zu Ihrem Hosting-Konto her und laden Sie den entpackten Dolibarr-Ordner manuell in das gewünschte Verzeichnis hoch.

6. Schritt 3: Erstellen einer MySQL-Datenbank über cPanel

  1. Gehen Sie zurück zu den Haupt-cPanel-Dashboard.

  2. Klicken Sie auf MySQL®-Datenbanken.

  3. Geben Sie unter „Neue Datenbank erstellen“ einen Namen ein und klicken Sie auf Datenbank erstellen.

  4. Scrollen Sie nach unten zu „MySQL-Benutzer“. Erstellen Sie einen neuen Benutzer und legen Sie ein sicheres Passwort fest.

  5. Wählen Sie unter „Benutzer zur Datenbank hinzufügen“ Ihren Benutzer und Ihre Datenbank aus und klicken Sie auf Speichern.

  6. Überprüfen Sie auf dem nächsten Bildschirm Alle Privilegien, dann klick Änderungen vornehmen.

Nimm zur Kenntnis:

  • Name der Datenbank

  • Datenbankbenutzer

  • Passwort

Diese benötigen Sie im nächsten Schritt.

7. Schritt 4: Festlegen der richtigen Dateiberechtigungen

Durch die entsprechenden Berechtigungen wird sichergestellt, dass Dolibarr in die erforderlichen Verzeichnisse schreiben kann:

  1. In Datei-Manager, klicken Sie mit der rechten Maustaste auf die folgenden Verzeichnisse und legen Sie die Berechtigungen fest auf 755:

  • /documents/

  • /conf/

  • /htdocs/custom/ (wenn Sie benutzerdefinierte Module verwenden möchten)

  1. Wenn der Installationsassistent später über Schreibberechtigungen klagt, setzen Sie diese vorübergehend auf 775, und kehren Sie nach der Einrichtung zu 755 zurück.

8. Schritt 5: Ausführen des Dolibarr-Installationsprogramms

  1. Öffnen Sie Ihren Browser und rufen Sie die URL auf, unter der Sie Dolibarr hochgeladen haben. Beispiel:

Klartext

https://yourdomain.com/erp/install/

  1. Das Installationsprogramm überprüft Ihre Serverumgebung.

  2. Klicke Start or Nächster Schritt, abhängig von Ihrer Version.

  3. Geben Sie die Datenbankdetails ein, die Sie in Schritt 3 erstellt haben.

  4. Richten Sie die Hauptadministratorkonto (das ist Ihr ERP-Superuser):

  • Benutzername

  • Passwort

  • E-Mail

  1. Klicken Sie weiter, um die Installation abzuschließen. Dolibarr wird:

  • Erstellen Sie die erforderlichen Datenbanktabellen

  • Standardparameter festlegen

  • Finalisieren Sie Ihre Instanz

  1. Sobald Sie fertig sind, schlägt das System vor Löschen oder Umbenennen der /install/ Flyer. Verwenden Sie den Dateimanager, um es zu löschen oder umzubenennen und so eine Neuinstallation zu verhindern.

9. Schritt 6: Konfiguration nach der Installation

Sobald Dolibarr installiert ist, werden Sie nach der Anmeldung zum ERP-Dashboard weitergeleitet. Bevor Sie das System nutzen, ist es wichtig, mehrere Erste Konfigurationsschritte.

Festlegen der Standardsprache und -region

Navigieren Sie zu:
Home > Setup > Anzeige > Sprachen
Wählen Sie Ihre bevorzugte Sprache (z. B. Englisch, Französisch, Arabisch) und aktivieren Sie sie.

Dann geh zu:
Home > Setup > Verschiedenes > Regionale Einstellungen
Legen Sie Folgendes fest:

  • Land

  • Zeitzone

  • Datumsformat

  • Zahlenformatierung (Dezimal-/Tausendertrennzeichen)

Konfigurieren des Firmenprofils

Geben Sie Ihre Geschäftsinformationen ein in:
Home > Setup > Firma/Organisation

Ergänze:

  • Offizieller Name

  • Umsatzsteuer-Identifikationsnummer

  • Logo

  • Registrierte Adresse

  • Beginn des Geschäftsjahres

Diese Informationen erscheinen auf allen offiziellen Dokumenten wie Rechnungen, Angeboten und Berichten.

10. Schritt 7: Sichern Ihrer Dolibarr-Instanz

Sicherheit ist unerlässlich, insbesondere auf Shared-Hosting-Plattformen wie cPanel. Hier sind wichtige Schritte zur Sicherung Ihres Dolibarr ERP.

Löschen des Installationsverzeichnisses

Gehen Sie zum Dateimanager und löschen Sie dauerhaft die /install/ Verzeichnis aus Ihrem Dolibarr-Ordner.

Beschränken Sie den Zugriff auf /documents/ Mappe

Erstellen Sie ein .htaccess Datei im Inneren /documents/ mit den folgenden:

Apache

<IfModule mod_rewrite.c> RewriteEngine on RewriteRule ^ - [F] </IfModule>

Dies verhindert den direkten Webzugriff auf hochgeladene Dokumente.

Aktivieren Sie HTTPS

Verwenden Sie cPanel Lass uns verschlüsseln SSL-Tool zum Installieren eines SSL-Zertifikats für Ihre Domain.

Aktualisieren Sie Dolibarrs conf.php um bei Bedarf HTTPS-URLs zu verwenden. Dies verhindert Cookie- und Session-Hijacking.

Dateiberechtigungen richtig festlegen

Stellen Sie nach der Installation sicher, dass sensible Verzeichnisse wie /conf/ Sind eingestellt auf chmod 755 oder strenger. Geben Sie ihnen keine Schreibberechtigungen.

PHP-Einstellungen aktualisieren

Über cPanel > PHP-Version auswählen > Optionen, Folgendes berücksichtigen:

  • memory_limit = 256M

  • post_max_size = 32M

  • upload_max_filesize = 32M

  • max_execution_time = 120

Dadurch wird sichergestellt, dass umfangreiche Vorgänge wie die PDF-Erstellung und das Hochladen großer Dateien nicht fehlschlagen.

11. Schritt 8: Zusätzliche Module installieren

Die Stärke von Dolibarr liegt in seiner modularen Architektur. Sie können zusätzliche Module installieren, um Funktionen wie diese zu aktivieren:

  • Personal- und Gehaltsabrechnung

  • Bestandsverwaltung:

  • Projekt Überwachung

  • Erweitertes CRM

  • Lokalisierte Rechnungsstellung

Installieren von Modulen aus einer ZIP-Datei

  1. Laden Sie das Modul von einer vertrauenswürdigen Quelle herunter (z. B. Dolistore).

  2. Gehen Sie zu cPanel > Dateimanager > /htdocs/custom/

  3. Laden Sie die ZIP-Datei des Moduls hier hoch und extrahieren Sie sie.

  4. Gehen Sie in Dolibarr zu Home > Setup > Module/Anwendungen

  5. Suchen Sie Ihr neues Modul in der Liste und klicken Sie auf Mehr erfahren

Stellen Sie sicher, dass alle Drittanbietermodule mit Ihrer Dolibarr-Version und Ihrem PHP-Setup kompatibel sind.

12. Schritt 9: Automatisieren von Backups und Updates

Automatisierte Backups in cPanel

Nutzen Sie cPanel > Sicherungsassistent oder einrichten Zeitgesteuerte Aufgaben um Datenbank- und Dateisicherungen zu automatisieren.

Du kannst auch:

  • Laden Sie /htdocs/conf/ kombiniert mit einem nachhaltigen Materialprofil. /documents/ Ordner

  • Exportieren Sie die MySQL-Datenbank mit phpMyAdmin

Dolibarr sicher aktualisieren

Wenn eine neue Version von Dolibarr veröffentlicht wird:

  1. Sichern Sie alles

  2. Überprüfen Sie die Modulkompatibilität

  3. Befolgen Sie die Upgrade-Dokumentation

  4. Ersetzen Sie die Kerndateien und führen Sie die Upgrade-Skript

Überschreiben Sie nicht die /documents/ or /conf/ Ordner während Upgrades. Testen Sie nach Möglichkeit immer in einer Staging-Umgebung.

13. Häufige Fehler und deren Behebung

Auch bei optimaler Konfiguration können Fehler auftreten. Hier finden Sie häufige Probleme und deren Lösungen.

Leerer Bildschirm beim Anmelden

Ursache: PHP-Fehler, wahrscheinlich aufgrund fehlender Erweiterungen.
Fix: Einblick in das error_log in cPanel oder aktivieren Sie die Fehlerberichterstattung in conf.php.

php

ini_set('display_errors', 1); error_reporting(E_ALL);

Verbindung zur Datenbank kann nicht hergestellt werden

Ursache: Falsche DB-Anmeldeinformationen oder falscher Hostname.
Fix: Überprüfen Sie Datenbankname, Benutzer und Passwort in conf.php.

Modul wird nach dem Hochladen nicht angezeigt

Ursache: Falscher Ordnerpfad oder ungültige Modulstruktur.
Fix: Stellen Sie sicher, dass der Modulordner korrekt unter /htdocs/custom/ und enthält eine gültige mod*.php Datei.

PDFs werden nicht generiert

Ursache: Fehlende PHP-Erweiterungen (zB gd, mbstring) oder ein Berechtigungsproblem.
Fix: Aktivieren Sie die erforderlichen Erweiterungen in cPanel und legen Sie die richtigen Berechtigungen fest für /documents/.

403 Verboten am /documents/

Ursache: Zugriff auf vertrauliche Ordner blockiert (was gut ist).
Fix: Wenn interne Funktionen nicht darauf schreiben können, passen Sie die Berechtigungen (755) oder den Besitz an (z. B. nobody, www-data) über das Support-Team Ihres Hosts.

14. Letzte Gedanken

Die Installation von Dolibarr auf cPanel ist eine praktische und leicht zugängliche Lösung für Unternehmen, die die volle Kontrolle über ihr ERP-System wünschen, ohne einen dedizierten Server oder fortgeschrittene Linux-Kenntnisse zu benötigen. Mit den in dieser Anleitung beschriebenen Schritten können Sie in nur wenigen Stunden eine voll funktionsfähige, sichere und skalierbare Dolibarr-Instanz einrichten.

Folgendes gewinnen Sie mit diesem Setup:

  • Ein Open-Source-ERP, das genau auf Ihre Bedürfnisse zugeschnitten ist

  • Kostengünstige Infrastruktur durch Shared Hosting

  • Flexibilität zur Erweiterung der Funktionen durch zertifizierte Module

  • Sicherer Zugriff mit voller Datenkontrolle

  • Kompatibilität mit Standardtools wie phpMyAdmin, FTP, SSL und Cron-Jobs

Egal, ob Sie ein kleines Unternehmen am Anfang Ihrer Karriere sind, ein etabliertes KMU, das Prozesse digitalisiert, oder ein Berater, der ERP für Kunden einführt, cPanel + Dolibarr bietet eine stabile und skalierbare Grundlage für das Wachstum.