Zum Hauptinhalt springen

Installationsassistent

LeadHub wird vollständig über Ihren Webbrowser installiert. Es gibt keine Kommandozeile, kein Terminal, kein SSH. Sie laden die Dateien hoch, öffnen eine URL und folgen fünf einfachen Schritten. Diese Anleitung führt Sie durch den gesamten Prozess.

Gesamtdauer: etwa 10–20 Minuten.

Bevor Sie Beginnen​

Stellen Sie sicher, dass Ihr Server die in der Serveranforderungen-Anleitung aufgelisteten Anforderungen erfüllt. Bestätigen Sie insbesondere:

  • PHP 8.3 oder höher ist für Ihre Domain aktiv
  • Sie haben eine MySQL-Datenbank (oder MariaDB) verfügbar — oder können eine erstellen (Anleitung unten)
  • Ihre storage/- und bootstrap/cache/-Verzeichnisse sind beschreibbar
  • Sie haben etwa 500 MB freien Speicherplatz

Schritt 1 — LeadHub-Dateien auf Ihren Server Hochladen​

Paket herunterladen​

Nach dem Kauf von LeadHub laden Sie das ZIP-Paket von Ihrer Kaufbestätigungsmail oder der Envato Downloads-Seite herunter. Die Datei heißt z.B. leadhub-v1.0.0.zip.

Im ZIP finden Sie alles, was LeadHub braucht — einschließlich des vendor/-Ordners, vorkompiliertem CSS und JavaScript und dem Installer selbst.

Upload über cPanel File Manager (einfachste Methode)​

  1. Melden Sie sich bei Ihrem cPanel-Konto an.
  2. Klicken Sie auf File Manager im Bereich Files.
  3. Navigieren Sie zum Installationsordner. Typischerweise:
    • public_html/ für die Hauptdomain
    • Ein Unterverzeichnis wie public_html/leadhub/
    • Ein dedizierter Addon-Domain-Ordner (empfohlen — siehe Shared-Hosting-Anleitung)
  4. Klicken Sie auf Upload in der Werkzeugleiste.
  5. Laden Sie die leadhub-v1.0.0.zip-Datei hoch.
  6. Nach dem Upload klicken Sie rechts auf die ZIP-Datei und wählen Extract.
  7. Extrahieren Sie in den korrekten Ordner.

Upload über FTP​

  1. Verbinden Sie sich mit Ihren FTP-Zugangsdaten.
  2. Navigieren Sie zum Zielordner auf dem Server.
  3. Ziehen Sie den entpackten leadhub-Ordner vom Computer zum Server.
  4. Warten Sie, bis alle Dateien hochgeladen sind (5–15 Minuten).

Tipp: Es ist schneller, die ZIP-Datei über File Manager hochzuladen und auf dem Server zu extrahieren, als tausende einzelne Dateien per FTP hochzuladen.

Schritt 2 — Dateiberechtigungen Setzen​

LeadHub muss in bestimmte Ordner schreiben können. Setzen Sie die folgenden Ordner auf Berechtigung 755.

In cPanel File Manager:​

  1. Öffnen Sie File Manager und navigieren Sie zum LeadHub-Ordner.
  2. Rechtsklick auf storage → Change Permissions.
  3. Setzen Sie auf 755 und aktivieren Sie „Recurse into subdirectories".
  4. Klicken Sie auf Change Permissions.
  5. Wiederholen Sie für bootstrap/cache (auf 755 setzen).

Schritt 3 — Installer im Browser Öffnen​

Öffnen Sie Ihren Browser und besuchen Sie:

https://ihredomain.com/install

Ersetzen Sie ihredomain.com durch Ihren tatsächlichen Domainnamen.

Bei einem 404-Fehler: Überprüfen Sie den Dateispeicherort und ob public/.htaccess korrekt hochgeladen wurde.

Bei einer leeren weißen Seite: Überprüfen Sie die PHP-Version in cPanel → MultiPHP Manager.

Installer Schritt 1 — Willkommen und Anforderungsprüfung​

Die erste Seite prüft automatisch:

  • PHP-Version — muss 8.3 oder höher sein
  • PHP-Erweiterungen — prüft alle 13 erforderlichen Erweiterungen
  • Verzeichnisberechtigungen — prüft Schreibbarkeit von storage/ und bootstrap/cache/

Bei Problemen​

PHP-Version zu niedrig: cPanel → MultiPHP Manager → auf PHP 8.3 ändern.

PHP-Erweiterung fehlt: cPanel → Select PHP Version → fehlende Erweiterung aktivieren → Save.

Verzeichnis nicht beschreibbar: cPanel → File Manager → Rechtsklick → Change Permissions → 755 mit Rekursion.

Wenn alles grüne Häkchen zeigt, klicken Sie auf „Next: Database".

Installer Schritt 2 — Datenbankkonfiguration​

FeldWas eingeben
Database HostNormalerweise localhost oder 127.0.0.1
PortNormalerweise 3306
Database NameDer Name Ihrer erstellten MySQL-Datenbank
Database UsernameIhr MySQL-Benutzername
Database PasswordDas Passwort des MySQL-Benutzers

MySQL-Datenbank in cPanel erstellen​

  1. In cPanel → MySQL Databases.
  2. Unter „Create New Database" Namen eingeben → Create Database.
  3. Unter „MySQL Users" → „Add New User" Benutzername und Passwort erstellen → Create User.
  4. Unter „Add User to Database" Benutzer und Datenbank auswählen → Add.
  5. „All Privileges" aktivieren → Make Changes.

Installer Schritt 3 — Administratorkonto​

FeldWas eingeben
Your NameIhr vollständiger Name
Email AddressIhre E-Mail-Adresse (wird zum Login-Benutzernamen)
PasswordEin sicheres Passwort (mindestens 8 Zeichen)
Confirm PasswordDasselbe Passwort
Workspace NameName Ihrer Organisation

Ein Workspace ist das Konto Ihrer Organisation in LeadHub. Bei der Erstinstallation werden Sie als Eigentümer mit Super-Admin-Rechten eingerichtet.

Klicken Sie auf „Next: License".

Installer Schritt 4 — Lizenz​

Geben Sie Ihren Envato-Kaufcode ein:

  1. Melden Sie sich bei Envato Market / CodeCanyon an.
  2. Profil → Downloads.
  3. LeadHub finden → „Download" → „License certificate & purchase code".
  4. Kaufcode kopieren.

Einfügen und „Next: Finish" klicken. Sie können diesen Schritt auch überspringen.

Installer Schritt 5 — Fertigstellung​

Klicken Sie auf „Install LeadHub". Der Installer führt automatisch aus:

  1. Konfigurationsdatei (.env) schreiben
  2. Datenbankmigrationen ausführen
  3. Datenbank mit Standardrollen befüllen
  4. Administratorkonto erstellen
  5. Workspace erstellen
  6. Speicherordner verknüpfen
  7. Konfiguration zwischenspeichern

Dauer: ca. 30–90 Sekunden. Danach werden Sie zu /admin weitergeleitet.

Die Installation ist abgeschlossen.

Checkliste nach der Installation​

1. Cron-Job Einrichten (KRITISCH)​

php /home/ihrbenutzername/leadhub/cron.php >> /dev/null 2>&1

Muss jede Minute ausgeführt werden. Siehe Shared-Hosting-Anleitung.

2. E-Mail Konfigurieren​

Einstellungen → E-Mail im Admin-Panel. SMTP-Details eingeben und Test-E-Mail senden.

3. Logo und Branding​

Einstellungen → Branding. Logo hochladen, Applikationsname und Farben setzen.

4. Erste Pipeline Erstellen​

Pipelines in der Seitenleiste. Pipeline erstellen und Stufen hinzufügen.

5. Erste Lead-Quelle Verbinden​

Lead Sources in der Seitenleiste. Erste Quelle verbinden.

Installer Erneut Ausführen​

Löschen Sie installed.lock aus storage/ und besuchen Sie /install erneut.

Warnung: Sichern Sie Ihre Datenbank vorher, da .env überschrieben und Migrationen erneut ausgeführt werden.

Fehlerbehebung​

ProblemWahrscheinliche UrsacheLösung
„Page not found" bei /installDateien am falschen Ort oder mod_rewrite inaktivDateispeicherort und .htaccess prüfen
Leere weiße SeitePHP-Fehler oder falsche PHP-VersionPHP 8.3 in cPanel MultiPHP Manager aktivieren
„Cannot connect to database"Falsche DatenbankzugangsdatenName (mit cPanel-Präfix), Benutzer und Passwort prüfen
Rote Warnungen bei ErweiterungenPHP-Erweiterungen nicht aktiviertcPanel → Select PHP Version, fehlende aktivieren
„storage is not writable"Falsche Berechtigungenstorage/ auf 755 rekursiv setzen
Installer hängt bei „Installing..."PHP-Speicherlimit zu niedrigAktualisieren; PHP-Speicherlimit prüfen (min. 128 MB)
/admin erreichbar aber Login unmöglichSitzung wird nicht gespeichertstorage/framework/sessions/ prüfen
„installation failed"Datenbankverbindung unterbrochenZugangsdaten und Schreibbarkeit von .env prüfen