Some checks failed
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 1m14s
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 1m16s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 1m17s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 1m17s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 1m21s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 1m19s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 1m14s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 1m12s
CI / Build-Artefakte aktuell (pull_request) Successful in 52s
- Nach der Einrichtung Erfolgsmeldung auf der Anmeldeseite (per Parameter, da die Sitzung beim Wechsel auf den Datenbank-Speicher verloren geht) - Root-.htaccess für Hoster ohne einstellbaren Webroot: leitet intern nach public/, .env und Programmdateien bleiben unerreichbar - Begrüßungskarte: Namen nicht mehr abschneiden; Personenzahl mit korrekter Einzahl - docs/INSTALLATION.md für Kunden: Voraussetzungen, Einrichtung, Cron, Updates - CI: vendor-Vergleich ohne composer/installed.php (enthält den Projekt-Commit) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
65 lines
3.1 KiB
Markdown
65 lines
3.1 KiB
Markdown
# 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.
|