Neue Instanz in Betrieb nehmen
Eine frisch installierte Plattform startet im Wartungsmodus. So machst du sie in Ruhe startklar und gibst sie am Ende frei:1
Konfiguration prüfen
Vor dem ersten Start trägt der Betreiber mindestens
APP_URL, APP_SECRET, ADMIN_EMAIL und ADMIN_PASSWORD ein, am besten auch APP_NAME und die Rechtstexte LEGAL_IMPRESSUM, LEGAL_DATENSCHUTZ und LEGAL_AGB (siehe Konfiguration und Rechtstexte der Plattform). MAILER_DSN darf leer bleiben, wenn du den E-Mail-Versand im Plattform-Admin einrichten willst.2
Zugangswort holen
Das Zugangswort steht im Log des Containers
migrate (Zeile „Zugangswort: …“) bzw. in der Ausgabe von app:install. Vergessen? php bin/console app:maintenance zeigt es an (siehe Konsolenbefehle).3
Anmelden und Konto absichern
Zugangsseite mit dem Wort öffnen, mit
ADMIN_EMAIL und ADMIN_PASSWORD anmelden. Unter Profil → Passwort ein neues, eigenes Passwort setzen, die Zwei-Faktor-Anmeldung einrichten und den Anzeigenamen „Admin“ durch deinen Namen ersetzen. ADMIN_PASSWORD danach aus der Konfiguration entfernen.4
Systemstatus prüfen
In der Übersicht muss die Umgebung
prod lauten und „Fehlgeschlagene Hintergrundjobs: 0“ stehen. Auf dem Server prüft php bin/console app:doctor Geheimnisse, Datenbank, Redis, Speicher, E-Mail und Stripe.5
E-Mail-Versand einrichten
Unter E-Mail-Versand den SMTP-Zugang eintragen (oder
MAILER_DSN in der Konfiguration), Speichern, dann Testmail an mich senden. Erst wenn die Testmail ankommt, können sich neue Nutzer selbst bestätigen.6
E-Mail-Signatur hinterlegen
Im selben Bereich unter E-Mail-Signatur die Pflichtangaben des Betreibers eintragen – Aus Impressum übernehmen liefert einen Vorschlag – und Signatur speichern. Mit einer zweiten Testmail das Ergebnis prüfen.
7
Rechtstexte kontrollieren
/impressum, /datenschutz und /agb aufrufen. Steht dort „Der Betreiber hat diesen Text noch nicht hinterlegt“, fehlt die jeweilige Variable. Die Vorlage für den Auftragsverarbeitungsvertrag liegt unter /legal/av-vertrag.8
Aussehen festlegen
Unter Darstellung das Template wählen (oder im Theme-Editor ein eigenes erstellen bzw. hochladen), Plattformname, Logo sowie Überschrift, Infobox und Fußzeile der Startseite eintragen. Danach die Startseite einmal hell und einmal dunkel ansehen.
9
Links
Unter Links die Kanäle des Betreibers eintragen. Geburtstag, Name und Anschrift der Mitglieder schaltet jede Community selbst ein – auf Plattform-Ebene ist dafür nichts nötig.
10
Optional: Zahlungen und Push
Sollen Owner bezahlte Pläne verkaufen, richtet der Betreiber Stripe ein (siehe Zahlungen einrichten); für Push-Benachrichtigungen braucht es VAPID-Schlüssel (
app:push:keys).11
Probelauf mit Testern
Das Zugangswort an Tester geben, eine Test-Community anlegen und Registrierung, Bestätigungsmail, Beitritt und Benachrichtigungen durchspielen. Test-Communities, die nicht beworben werden sollen, unter Communities im Verzeichnis ausblenden.
12
Wartungsmodus ausschalten
Unter Wartung Wartungsmodus ausschalten. Ist
MAINTENANCE_MODE=on gesetzt, muss der Betreiber die Variable leeren oder auf off setzen.Weiteren Plattform-Admin hinzufügen
- Die Person registriert sich normal und bestätigt ihre E-Mail-Adresse.
- Unter Nutzer nach ihrer Adresse suchen und Zum Admin machen.
- Kommt die Bestätigungsmail nicht an: zuerst den E-Mail-Versand prüfen; ist die Adresse sicher richtig, E-Mail bestätigen und dann Zum Admin machen.
- Die Person bitten, die Zwei-Faktor-Anmeldung einzurichten.
php bin/console app:user:promote <email> --verify.
Auf eine Meldung über eine Community reagieren
- Unter Communities die Community suchen und den Owner (E-Mail in der Liste) informieren.
- Die Inhalte prüfen – als Plattform-Admin kannst du die Community öffnen, auch wenn sie privat ist.
- Reicht es, einzelne Beiträge oder Mitglieder zu moderieren, das dem Team der Community überlassen bzw. selbst moderieren.
- Nur im Notfall Sperren. Laufende Abos laufen weiter – das mit dem Owner klären.
- Nach der Klärung Freigeben. Sperre und Freigabe stehen im Protokoll.
Jemand kommt nicht in sein Konto
Design wechseln, ohne etwas zu verlieren
- Unter Darstellung das bisherige Template sichern: Herunterladen (eigene) bzw. Kopie herunterladen (mitgelieferte).
- Neues Template hochladen oder im Theme-Editor erstellen und die Kontrast-Prüfung beachten.
- Verwenden – die Änderung gilt sofort für alle. Gefällt sie nicht, wieder das vorige Template Verwenden oder bei einem eigenen Template Vorige Fassung wiederherstellen.
- Communities mit eigener Primärfarbe kurz ansehen, ob ihre Farbe zum neuen Template passt – Schriften, Flächen und Rundungen kommen immer aus dem Template.
Nach einem Update
- Die Hinweise zur neuen Version unter Änderungen und Updates lesen.
- Übersicht: Fehlgeschlagene Hintergrundjobs = 0, E-Mail-Versand mit der erwarteten Quelle.
- Testmail senden und die Startseite sowie eine Community aufrufen.
- Bei Zahlungen: Verlangt die neue Version zusätzliche Stripe-Ereignisse, sie in der Event Destination (bzw. am Webhook) im Stripe-Konto ergänzen und je Community
app:billing:sync <slug>ausführen.