Zum Inhalt springen

Erste Schritte

Nach der Installation

Die Reihenfolge der ersten beiden Schritte ist nicht beliebig: Der erste Administrator wird mit einer unbestätigten Adresse angelegt. Bis zur Bestätigung kann dieses Konto alles — Einstellungen, Nutzer, Seiten, Aufsicht — nur keine Shortlinks anlegen. Und die Bestätigung braucht den Mail-Versand.

  1. Mail-Versand einrichten — Einstellungen → E-Mail, dann Test-Mail senden. Die Schaltfläche zeigt die Serverantwort im Klartext.
  2. Eigene Adresse bestätigen — Konto → „Bestätigungsmail senden", dann den Link in der Mail anklicken. Kommt sie nicht an, ist die Adresse falsch geschrieben oder der Versand nicht in Ordnung. Dieselbe Adresse trägt später den Passwort-Reset und die Benachrichtigung über automatisch stillgelegte Links.
  3. Zwei-Faktor-Anmeldung einrichten — Konto → Sicherheit. Wiederherstellungs-Codes an einem anderen Ort ablegen als das Passwort.
  4. Name und Logo setzen — Einstellungen → Allgemein.
  5. Verhalten bei Zielen festlegen — Einstellungen → Links: vertrauenswürdige Domains, Vorschauseite, Prüf-Frist. Siehe Ziel-Prüfung.
  6. Funktionen durchgehen — Einstellungen → Funktionen.
  7. Public Suffix List holen — php artisan shortlink:suffix-list.
  8. Pflichtseiten füllen — Seiten. Impressum, Datenschutzerklärung und Barrierefreiheitserklärung liegen als Platzhalter bereit. Die Barrierefreiheitserklärung braucht einen erreichbaren Feedback-Weg; ein mailto:-Link genügt.
  9. Cron einrichten — beide Einträge.
  10. Backup einrichten und eine Wiederherstellung testen — siehe Backup.

Der Config-Cache friert die .env ein

Der Installer baut am Ende die drei Betriebs-Caches (config, routes, views). Das heißt: Jede spätere Änderung an der .env braucht php artisan config:clear — sonst wirkt sie nicht. Die Aktualisierung erneuert die Caches von sich aus.

Konnte der Installer sie nicht bauen, sagt er das — auf der Kommandozeile als gelbe Zeile, im Browser als Meldung auf der Abschlussseite. Hole sie dann von Hand nach:

php artisan config:cache && php artisan route:cache && php artisan view:cache

In einer Entwicklungsumgebung (APP_ENV=local) baut der Installer sie bewusst nicht.

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