Dokumentation · Version 26.207 STABLE

Installation ohne 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. Eine neue, leere MySQL-/MariaDB-Datenbank und einen eigenen Benutzer einrichten.
  2. ZIP unter beispielsweise /srv/vertragsmanager entpacken; Apache-DocumentRoot beziehungsweise Nginx-root auf /srv/vertragsmanager/public setzen.
  3. PHP-FPM, HTTPS und PHP 8.2+ mit pdo_mysql konfigurieren.
  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.