Dokumentation · Version 26.207 STABLE

Installation mit Plesk

Aktuelle Anleitung zur vollständigen Neuinstallation und zur Wartung des VertragsManagers.

Aktuell: 26.207 STABLE. Für eine Neuinstallation das vollständige ZIP verwenden, nicht das kumulative Update. Der Lizenzserver ist unter portal.4-box.de erreichbar. Die Vollinstallation wurde statisch geprüft; ein vollständiger End-to-End-Test mit MariaDB/MySQL auf einem Zielserver steht noch aus.

1. Voraussetzungen

  • PHP 8.2 oder neuer, PDO MySQL; empfohlen auch mbstring, openssl, sodium und zip.
  • HTTPS und eine leere MySQL-/MariaDB-Datenbank mit eigenem Benutzer.
  • Vollinstallation 26.207 STABLE herunterladen.

2. Dateien und Datenbank bereitstellen

  1. In Plesk unter „Datenbanken“ eine neue, leere Datenbank und einen eigenen Benutzer anlegen.
  2. ZIP im Dateimanager in ein Projektverzeichnis entpacken und den Hosting-Document-Root auf dessen public/ setzen.
  3. PHP 8.2+ mit pdo_mysql und benötigten Erweiterungen aktivieren; HTTPS einschalten.
  4. Interne Ordner app/ und sql/ dürfen nicht öffentlich erreichbar sein.
  5. Für den Installationsassistenten muss der PHP-Prozess app/config.php und app/install.lock anlegen können. Keine pauschalen Rechte 777 vergeben.

3. Installationsassistent

  1. https://DEINE-DOMAIN/install.php aufrufen.
  2. Datenbankhost, Datenbankname, Benutzer und Passwort eintragen.
  3. Ersten Administrator mit einem sicheren Passwort anlegen.
  4. Assistenten abschließen: Das Paket enthält sql/install_26.207_full.sql mit dem aktuellen Tabellenaufbau und Standardkategorien.
  5. Anmelden und die Anwendung prüfen. Anschließend public/install.php löschen oder serverseitig sperren; Schreibrechte nach Möglichkeit einschränken.

Achtung: Der Installer ist ausschließlich für neue, leere Datenbanken bestimmt. Niemals auf einer bestehenden Installation ausführen oder deren Datenbank überschreiben.

4. Lizenz, Berechtigungen und Sicherheit

  • Lizenz im Adminbereich aktivieren; Lizenzserver: https://portal.4-box.de/api/check.php.
  • Domainbindung und HTTPS-Erreichbarkeit prüfen.
  • Die vom VertragsManager erzeugte Datei app/contract_portal_secret.key sichern: Ohne sie sind verschlüsselte Kundenportal-Passwörter nicht wiederherstellbar.
  • Die Konfiguration app/config.php niemals veröffentlichen oder ins Downloadarchiv mit persönlichen Zugangsdaten aufnehmen.

5. Updates und Backups

  • Vor jedem Update Datenbank und Dateien sichern.
  • Bestehende Installationen über den integrierten Updater und den STABLE-Kanal aktualisieren.
  • Die Vollinstallation ist kein Updater-Paket. Das Grundschema sql/install_26.207_full.sql nicht über eine bestehende Datenbank importieren.
  • Alte Pakete vor 26.207 nicht für Neuinstallationen verwenden.

6. SMTP und Hintergrundaufgaben

SMTP im Adminbereich einrichten und eine Testmail versenden. Für den asynchronen Versand kann ein CLI-Worker im Projektstamm erforderlich sein:

* * * * * /usr/bin/php /PFAD/ZUM/VERTRAGSMANAGER/mail_outbox_worker.php

Pfad und PHP-Interpreter an die Hostingumgebung anpassen; als Anwendungsbenutzer, nicht als root ausführen. Die Mail-Schlüssel müssen für Web-PHP und CLI konsistent verfügbar sein. Die separaten Lizenzserver-Cronjobs gehören nicht in das VertragsManager-Verzeichnis.

7. Häufige Fehler

  • 404 bei install.php: Document-Root auf public/ prüfen.
  • Datenbankverbindung: Host, Zugangsdaten, Berechtigungen und pdo_mysql prüfen.
  • HTTP 500: PHP-/Webserver-Logs, Dateirechte und PHP-Erweiterungen prüfen.
  • Lizenzprüfung: HTTPS zu portal.4-box.de und Domainbindung prüfen.
  • E-Mail: SMTP-Einstellungen, Mail-Schlüssel, Worker und Fehlerprotokolle kontrollieren.