Shared-Hosting-Leitfaden
Diese Anleitung führt durch die Installation von LeadHub auf einem typischen cPanel-Shared-Hosting-Konto. Kein SSH, kein Terminal, kein Root-Zugang erforderlich.
Was Sie benötigen
- cPanel File Manager (oder FTP)
- cPanel MySQL-Datenbanken
- cPanel Cron-Jobs
- Ein Webbrowser
Schritt 1 — Datenbank erstellen
- Klicken Sie in cPanel auf MySQL-Datenbanken.
- Erstellen Sie eine neue Datenbank, z. B.
username_leadhub. - Erstellen Sie einen neuen Datenbankbenutzer, z. B.
username_lhuser, mit einem sicheren Passwort. - Fügen Sie den Benutzer zur Datenbank hinzu und erteilen Sie Alle Berechtigungen.
- Notieren Sie: Datenbankname, Benutzername, Passwort und Host (normalerweise
localhost).
Schritt 2 — Dateien hochladen
Option A — File Manager:
- Gehen Sie zu cPanel → File Manager.
- Navigieren Sie zu
public_html/(oder einem Unterverzeichnis, falls LeadHub in einem Ordner stehen soll). - Klicken Sie auf Hochladen und laden Sie die LeadHub-ZIP-Datei hoch.
- Nach dem Hochladen klicken Sie mit der rechten Maustaste auf die ZIP → Entpacken nach
public_html/.
Option B — FTP:
- Verwenden Sie FileZilla oder einen anderen FTP-Client.
- Verbinden Sie sich mit Ihrem Hosting über Ihre FTP-Zugangsdaten.
- Laden Sie alle Dateien aus dem entpackten LeadHub-Ordner direkt in
public_html/hoch.
⚠️ Stellen Sie sicher, dass
index.phpdirekt inpublic_html/liegt — nicht in einem Unterordner.
Schritt 3 — Berechtigungen setzen
Im cPanel File Manager:
- Wählen Sie den Ordner
storage/→ Rechtsklick → Berechtigungen ändern → auf755setzen, Unterverzeichnisse einschließen aktivieren. - Wiederholen Sie den Vorgang für
bootstrap/cache/.
Schritt 4 — Installer ausführen
Öffnen Sie Ihren Browser und navigieren Sie zu:
https://ihredomain.com/install
Schließen Sie den Wizard gemäß der Installationsanleitung ab.
Schritt 5 — Cron-Job einrichten
- Klicken Sie in cPanel auf Cron-Jobs.
- Stellen Sie unter Neuen Cron-Job hinzufügen die Allgemeinen Einstellungen auf „Jede Minute (
* * * * *)" ein. - Geben Sie im Feld Befehl Folgendes ein:
/usr/bin/php /home/ihrbenutzername/public_html/cron.php >> /dev/null 2>&1Ersetzen Sie
ihrbenutzernamedurch Ihren tatsächlichen cPanel-Benutzernamen und passen Sie den Pfad an, falls LeadHub in einem Unterverzeichnis liegt. - Klicken Sie auf Neuen Cron-Job hinzufügen.
Schritt 6 — Cron-Job überprüfen
Gehen Sie nach 2–3 Minuten im LeadHub Super-Admin-Panel zu Systemstatus. Der Warteschlangenstatus sollte grün angezeigt werden. Wenn „Warteschlange läuft nicht" angezeigt wird, überprüfen Sie den Cron-Pfad erneut.
Installation in einem Unterverzeichnis
Wenn Sie LeadHub unter ihredomain.com/leadhub/ statt im Stammverzeichnis betreiben möchten:
- Laden Sie die Dateien in
public_html/leadhub/hoch. - Geben Sie während der Installation als App-URL
https://ihredomain.com/leadhuban. - Der Cron-Pfad lautet dann
/home/ihrbenutzername/public_html/leadhub/cron.php.
Subdomain-Installation
So installieren Sie LeadHub unter app.ihredomain.com:
- Erstellen Sie in cPanel → Domains (oder Subdomains) den Eintrag
app.ihredomain.comund verweisen Sie ihn z. B. aufpublic_html/leadhub/. - Laden Sie die Dateien in
public_html/leadhub/hoch. - Setzen Sie die App-URL auf
https://app.ihredomain.com.
PHP-Versionscheck
Falls Ihr cPanel über den MultiPHP-Manager verfügt:
- Gehen Sie zu MultiPHP-Manager.
- Suchen Sie Ihre Domain/Subdomain.
- Wählen Sie PHP 8.4 (oder die höchste verfügbare 8.x-Version).
- Speichern.
Häufige cPanel-Probleme
| Problem | Lösung |
|---|---|
.htaccess funktioniert nicht | mod_rewrite über cPanel → Apache-Handler aktivieren oder den Hoster kontaktieren |
| 500 Internal Server Error | storage/logs/laravel.log im File Manager prüfen |
| PHP-Erweiterung fehlt | cPanel → PHP-Version auswählen → fehlende Erweiterung aktivieren |
| Warteschlange läuft nicht | Cron-Pfad prüfen — exakten Pfad aus dem Systemstatus verwenden |
| Dateiberechtigung verweigert | storage/ und bootstrap/cache/ rekursiv auf 755 setzen |