# Installation und Betrieb Diese Anleitung richtet sich an die IT bzw. an die Person, die das Portal beim Hoster einrichtet. Shell-Zugang wird nicht benötigt. ## Voraussetzungen - PHP **8.3** oder neuer mit den Erweiterungen `pdo_mysql`, `mbstring`, `openssl`, `intl`, `gd`, `zip`, `fileinfo`, `tokenizer`, `ctype`, `xml`, `dom` - **MySQL ab 8.0** oder **MariaDB ab 10.6** – eine leere Datenbank samt Benutzer - Apache mit `mod_rewrite` (Einstellungen per `.htaccess` müssen erlaubt sein) - Empfohlen: OPcache, `memory_limit` ≥ 128M, `upload_max_filesize` ≥ 8M, HTTPS - Ausgehende HTTPS-Verbindungen zu `update.loheide.cloud` und `api.loheide.cloud` (für Aktualisierungen und Rückmeldungen) ## Einrichtung 1. Das Installationsarchiv entpacken und **alle** Dateien per FTP/SFTP oder Dateimanager in das gewünschte Verzeichnis hochladen. 2. Webroot festlegen: - **Empfohlen:** Die Domain zeigt auf das Unterverzeichnis `public/`. - Lässt der Hoster das nicht zu, zeigt die Domain auf das Installationsverzeichnis – die mitgelieferte `.htaccess` leitet dann alle Anfragen nach `public/` weiter. 3. Schreibrechte für den Webserver: `storage/`, `bootstrap/cache/`, `public/uploads/` und – damit Aktualisierungen per Klick funktionieren – für das gesamte Installationsverzeichnis. 4. Die Adresse des Portals im Browser aufrufen. Der Einrichtungsassistent führt durch **Systemprüfung → Datenbank → Administrator**. Lizenz-E-Mail und Lizenzschlüssel können dabei oder später eingetragen werden. 5. Mit dem Administratorkonto anmelden und unter **Administration → Systemzustand** die Hinweise durchgehen. > Solange die Einrichtung nicht abgeschlossen ist, kann jede Person, die die > Adresse kennt, den Assistenten ausfüllen. Die Einrichtung daher direkt nach > dem Hochladen abschließen. ## Hintergrundaufgaben Rückmeldungen, geplante Inhalte und Aufräumarbeiten laufen im Hintergrund. Die genauen Angaben zeigt **Systemzustand** an. - **Am besten:** Cronjob beim Hoster, jede Minute: `cd /pfad/zum/portal && php artisan schedule:run` - **Ohne Cron-Zugang:** die unter Systemzustand angezeigte geheime Web-Cron-Adresse jede Minute von einem externen Cron-Dienst aufrufen lassen. - **Ohne beides** laufen die Aufgaben beim Aufruf von Seiten mit – das funktioniert, ist aber weniger zuverlässig. ## Aktualisierungen Unter **Administration → Aktualisierung**: „Nach Updates suchen“ und „Jetzt aktualisieren“. Das Portal zeigt währenddessen eine Wartungsseite, übernimmt die neue Fassung, bringt die Datenbank auf den neuen Stand und ist nach wenigen Minuten wieder erreichbar. `.env`, `storage/`, hochgeladene Dateien und Plugins werden dabei nie verändert. Voraussetzung ist eine gültige Lizenz. Ein Lizenzproblem schränkt die Nutzung des Portals nicht ein – es verhindert nur den Bezug neuer Fassungen. ## Umzug auf einen anderen Server Alle Dateien (inklusive `.env` und `storage/`) und die Datenbank übertragen. Anschließend unter **Aktualisierung** die alte Installation abmelden bzw. die Lizenz neu prüfen – jede Installation belegt einen Geräteplatz der Lizenz.