Betrieb

Konfiguration in der .env

Die Schlüssel der .env, ihre Vorgaben und ihre Wirkung. Die kommentierte Vorlage ist .env.example.

Grundlagen

Schlüssel Bedeutung
APP_ENV Im Betrieb production
APP_DEBUG Im Betrieb false. true zeigt bei Fehlern interne Pfade und Konfigurationswerte
APP_KEY Wird von key:generate gesetzt. Verlust macht verschlüsselte Sitzungen, das gespeicherte Mail-Passwort und die Zwei-Faktor-Geheimnisse unlesbar
APP_URL Vollständige öffentliche Adresse mit https://, ohne Schrägstrich am Ende. Steht in allen Links in System-Mails
APP_TIMEZONE Zeitzone für Anzeige und gespeicherte Zeitstempel. Standard Europe/Berlin. Nur vor dem ersten Produktivdatensatz ändern — siehe unten
APP_NAME Nur Präfix für Cache-, Session- und Queue-Schlüssel — nicht der angezeigte Name
DB_* Datenbank-Zugang. DB_PREFIX nur bei geteilter Datenbank und nur vor der ersten Migration setzen
SESSION_DRIVER database (Standard)
SESSION_LIFETIME Leerlauf in Minuten, bis eine Sitzung verfällt. Standard 120
SESSION_SECURE_COOKIE Auf einer Installation mit HTTPS true. Ohne diesen Schalter kann das Session-Cookie im Klartext übertragen werden
SESSION_SAME_SITE lax (Standard) — Schutz gegen Cross-Site-Requests
QUEUE_CONNECTION database (Standard). Die Aufträge arbeitet der Queue-Worker ab — siehe Cron einrichten
MAIL_* Nur Ausgangswerte. Sobald unter Einstellungen → E-Mail ein Zugang gepflegt ist, hat dieser Vorrang
LOG_LEVEL warning (Vorgabe in .env.example). Fehlt der Schlüssel, gilt debug

Mehrere Domains auf derselben Installation. Zeigen weitere Domains auf diesen Server — www. davor, eine Testdomain, die nackte IP —, funktioniert die Anwendung über jede von ihnen vollständig. Ausgegeben wird aber immer die Adresse aus APP_URL: Die Links in System-Mails — Passwort zurücksetzen, Einladung, Adresse bestätigen — tragen sie, gleich über welche Domain die Mail ausgelöst wurde. Links und Formulare innerhalb einer geöffneten Seite bleiben auf dem Host, über den zugegriffen wird.

Wer die Oberfläche angemeldet über eine andere Domain öffnet, sieht unter der Kopfzeile einen dauerhaften Hinweis, der beide Adressen nennt. Besucher öffentlicher Seiten sehen ihn nie.

Fehlt APP_URL oder steht dort kein Schema (https://) davor, gilt der Host der Anfrage. Einstellungen → Systemdaten meldet diesen Zustand als Warnung.

Zwei .env-Syntaxregeln, die stumm zuschlagen. Ein # in einem nicht quotierten Wert schneidet ihn ab — aus Ge#heim wird Ge, ohne Fehlermeldung. Und ein Leerzeichen in einem nicht quotierten Wert ist ein Parse-Fehler, nach dem die Anwendung gar nicht mehr startet. Passwörter, Schlüssel und alles mit Sonderzeichen deshalb immer in doppelte Anführungszeichen setzen. Im Zweifel nachsehen statt annehmen: php artisan tinker --execute="var_dump(env('MAIL_PASSWORD'));"

Formrelay-eigene Schlüssel

Schlüssel Standard Bedeutung
FORMRELAY_NAME Formrelay Ausgangswert des angezeigten Namens; überschreibbar in Einstellungen → Allgemein
FORMRELAY_UPDATE_CHECK true Ausgangswert für „Auf neue Fassungen hinweisen" (Einstellungen → Systemdaten). false, wenn diese Installation keine Verbindung nach außen aufbauen soll — die Abfrage verrät dem Anbieter IP-Adresse und Zeitpunkt
FORMRELAY_UPDATE_SOURCE GitLab-API des Projekts Woher die Release-Liste kommt. Nur ändern, wenn du eine eigene Fassung pflegst. Leer schaltet die Abfrage ab
FORMRELAY_DNS_CHECKS true SPF- und DMARC-Hinweise zur Absenderdomain (Installer, Einstellungen → E-Mail, formrelay:mail-test). Gefragt wird der Resolver des Servers nach den TXT-Einträgen der eigenen Domain. false, wenn er nach außen nicht antwortet
FORMRELAY_SEED_ADMIN_EMAIL, FORMRELAY_SEED_ADMIN_PASSWORD admin@example.com, password Nur für php artisan db:seed in Entwicklung und CI. Im Betrieb ohne Wirkung

Aufbewahrungsfristen stehen nicht in der .env, sondern in der Datenbank — ein Administrator stellt sie unter Einstellungen → Funktionen ein.

Zwei Pfade stehen nicht in der .env, sondern in config/formrelay.php: env_file und version_file. Vorgabe ist jeweils null — die .env bzw. die Datei VERSION im Projektverzeichnis.

Nach jeder Änderung an der .env:

php artisan config:cache

Zeitzone

Standard ist Europe/Berlin, nicht Laravels Vorgabe UTC. Für Installationen in anderen Zonen: APP_TIMEZONE=Europe/Vienna (oder Europe/Zurich und so weiter).

Diese Entscheidung gehört an den Anfang. Zeitstempel werden in dieser Zone geschrieben und gelesen. Wird die Zone später gewechselt, verschiebt sich die Deutung aller bereits gespeicherten Werte um die Differenz der Zonen. Bei einer laufenden Installation ist das kein Konfigurations-, sondern ein Datenthema.

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