Erste Schritte

Systemanforderungen

Pflicht

Bereich Anforderung
PHP 8.4.1 oder neuer
PHP-Erweiterungen pdo_mysql, mbstring, openssl, fileinfo, ctype, tokenizer, json, xml
Datenbank MySQL 8 oder MariaDB 10.6 und neuer. Datenbank und Benutzer mit vollen Rechten legst du selbst an — Formrelay tut es nicht. SQLite und PostgreSQL laufen technisch, sind aber nicht geprüft
Webserver nginx oder Apache mit PHP-FPM, Document-Root auf public/
TLS Zertifikat für die Domain
Composer 2.x
Zugang SSH
Zeitsteuerung Zwei Cron-Einträge, einer davon minütlich für den Queue-Worker. Den Worker-Eintrag kann ein dauerhaft laufender Worker (Supervisor, systemd) ersetzen. Siehe Cron einrichten
Schreibrechte storage/ und bootstrap/cache/ für den PHP-Prozess beschreibbar

Nicht nötig

Node.js / npm Nur beim Weg über das Repository, und dort einmalig auf dem eigenen Rechner. Das Release-Paket bringt CSS und JavaScript fertig gebaut mit

Dringend empfohlen

  • HTTPS. Ohne TLS gehen Passwörter und Sitzungs-Cookies im Klartext über die Leitung, und „Kopieren" funktioniert im Browser nicht.
  • Mail-Versand. Ohne ihn lassen sich keine Konten einrichten, keine Passwörter zurücksetzen und keine Adressen ändern.

Prüfen

php artisan formrelay:check

Prüft PHP-Version, Erweiterungen, ob die Betriebsverzeichnisse vorhanden und beschreibbar sind und ob die .env nicht für alle lesbar ist. Ändert nichts, braucht weder .env noch Datenbank — läuft also schon vor der Installation. Die Beschreibbarkeit prüft der Befehl mit einem echten Schreibversuch.

Nach der Installation steht eine erweiterte Prüfung unter Einstellungen → Systemdaten → Ausführliche Diagnose.

Geteilte Datenbank

Die Datenbank muss nicht leer sein. Teilst du sie mit anderen Anwendungen, vergib bei der Installation ein Tabellen-Präfix (--db-prefix, im Assistenten ein eigenes Feld). Nur vor der ersten Migration setzen.

Quelle dieser Seite: docs/systemanforderungen.md im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die Markdown-Datei, nicht in diese Seite.