Installation

Mit dem Web-Assistenten installieren Sie LKWaWi in wenigen Schritten auf Ihrem Webserver. Sie benötigen dafür ein geeignetes Hosting, eine leere Datenbank und einen gültigen Lizenzschlüssel.

Vor der Installation

Prüfen Sie zunächst, ob Ihr Server die folgenden Voraussetzungen erfüllt:

• PHP 8.3, 8.4 oder 8.5
• PHP-Erweiterungen PDO MySQL, cURL, OpenSSL und JSON
• PHP-Erweiterung ZipArchive für Updates und Sicherungen
• MySQL 8 oder MariaDB 10.6 oder neuer
• eine eigene Domain oder Subdomain mit gültigem HTTPS-Zertifikat
• Zugriff auf Dateien, Datenbanken und Hosting-Einstellungen
• ein gültiger LKWaWi-Lizenzschlüssel

Hosting vorbereiten: PHP wählen, Datenbank anlegen, Paket entpacken und Document Root setzen.

1. Datenbank anlegen

Legen Sie in Plesk oder Ihrer Hosting-Verwaltung eine leere MySQL- oder MariaDB-Datenbank an. Erstellen Sie dazu einen eigenen Datenbankbenutzer und geben Sie ihm alle Rechte für diese Datenbank.

Halten Sie folgende Angaben für den Setup-Assistenten bereit:

• Datenbankhost, beispielsweise 127.0.0.1
• Datenbankport, meistens 3306
• Datenbankname
• Datenbankbenutzer
• Datenbankpasswort

Wichtig: Wenn Ihr Hoster einen abweichenden Port vorgibt, tragen Sie Host und Port in die getrennten Felder des Assistenten ein.

2. LKWaWi hochladen

1. Laden Sie das aktuelle Stable-Paket aus Ihrem Kundenbereich herunter.
2. Laden Sie die ZIP-Datei in das Zielverzeichnis Ihrer Domain oder Subdomain hoch.
3. Entpacken Sie das Paket vollständig.
4. Prüfen Sie, ob sich im entpackten Ordner unter anderem die Verzeichnisse public, src, resources und storage befinden.

Verwenden Sie immer ein unverändertes vollständiges Paket. Übernehmen Sie keine .env-Datei aus einer anderen Installation.

3. Document Root einstellen

Die Domain muss direkt auf den Ordner public der entpackten LKWaWi zeigen. In Plesk finden Sie diese Einstellung bei der betreffenden Domain unter Hosting & DNS beziehungsweise Hosting-Einstellungen.

Beispiel:

/var/www/vhosts/example.tld/wawi.example.tld/LKWaWi/public

Aktivieren Sie außerdem ein gültiges SSL-/TLS-Zertifikat und rufen Sie die WaWi ausschließlich über HTTPS auf.

4. Dateirechte prüfen

Der PHP-Prozess muss während der Einrichtung die Konfigurationsdatei .env im LKWaWi-Hauptverzeichnis erstellen können. Auch der Ordner storage muss für Protokolle, Sicherungen und Update-Dateien beschreibbar sein.

Bei Plesk genügt normalerweise, dass Dateien und Verzeichnisse dem Benutzer der Domain gehören. Verwenden Sie keine pauschalen Rechte wie 777.

5. Setup-Assistent öffnen

Öffnen Sie die neue WaWi-Domain im Browser. Solange die Installation noch nicht eingerichtet wurde, leitet LKWaWi automatisch auf /setup weiter.

Im oberen Bereich sehen Sie die technische Prüfung. Alle Voraussetzungen sollten grün markiert sein. Tragen Sie anschließend die folgenden Angaben ein:

1. Anwendung: vollständige HTTPS-Adresse und Zeitzone, üblicherweise Europe/Berlin
2. Datenbank: Host, Port, Datenbankname, Benutzer und Passwort
3. Erster Admin: Name, E-Mail-Adresse und ein eigenes starkes Passwort mit mindestens 10 Zeichen

Der Setup-Assistent prüft die Umgebung und führt durch alle benötigten Angaben.

Klicken Sie auf Setup starten und Admin erstellen. LKWaWi prüft nun die Datenbankverbindung, erstellt die Konfiguration, führt die Datenbankmigrationen aus und legt den ersten Admin-Benutzer an.

Nach erfolgreichem Abschluss wird der Setup-Assistent automatisch gesperrt und Sie gelangen zur Anmeldung.

6. Lizenz aktivieren

Melden Sie sich mit dem soeben erstellten Admin-Zugang an. Eine neue Installation bleibt zunächst auf die Lizenzverwaltung beschränkt.

1. Öffnen Sie den angezeigten Lizenzbereich.
2. Tragen Sie Ihren LKWaWi-Lizenzschlüssel ein.
3. Klicken Sie auf Lizenzdaten speichern.
4. Klicken Sie anschließend auf Lizenz jetzt prüfen.

Erst nach einer erfolgreichen ersten Lizenzprüfung werden die für Ihren Tarif freigeschalteten Bereiche nutzbar. Eine mögliche Karenzzeit beginnt nicht vor dieser Erstaktivierung.

7. Shop-Anbindung einrichten

Nach der Lizenzaktivierung können Sie unter Einstellungen > Shop-Anbindungen Ihren Shop verbinden. Halten Sie dafür die Shop-URL und die Zugangsdaten der jeweiligen Shop-Integration bereit.

Prüfen Sie zuerst die Verbindung und starten Sie anschließend unter Einstellungen > Import & Synchronisation den Erstimport.

Installation prüfen

Die Installation ist vollständig abgeschlossen, wenn:

• die Anmeldung mit dem Admin-Benutzer funktioniert,
• die Lizenz als gültig angezeigt wird,
• die gewünschte Shop-Anbindung den Verbindungstest besteht,
• unter System & Wartung keine fehlenden Voraussetzungen gemeldet werden,
• eine erste manuelle Sicherung erfolgreich erstellt werden kann.

Häufige Probleme

/setup zeigt eine 404-Seite

Prüfen Sie, ob der Document Root wirklich auf den Ordner public zeigt. Bei Apache müssen außerdem mod_rewrite und die Auswertung der enthaltenen .htaccess-Datei aktiv sein.

Die .env-Datei kann nicht erstellt werden

Prüfen Sie Eigentümer und Schreibrechte des LKWaWi-Hauptverzeichnisses. Der Domain- beziehungsweise PHP-Benutzer muss dort während des Setups schreiben dürfen.

Die Datenbankverbindung schlägt fehl

Prüfen Sie Host, Port, Datenbankname, Benutzer und Passwort. Verwenden Sie die Werte genau so, wie sie in Ihrem Hosting hinterlegt sind.

Nach dem Login ist nur die Lizenzseite erreichbar

Dieses Verhalten ist bei einer neuen Installation vorgesehen. Speichern Sie einen gültigen Lizenzschlüssel und führen Sie die erste Lizenzprüfung aus.

Das Setup wurde teilweise ausgeführt

Löschen Sie weder Tabellen noch Konfigurationsdateien ohne Sicherung. Dokumentieren Sie die angezeigte Fehlermeldung und wenden Sie sich an den Support, damit der vorhandene Stand geprüft werden kann.