---
title: "Checklisten"
description: "Typische Aufgaben Schritt für Schritt: neue Instanz in Betrieb nehmen, Plattform-Admin hinzufügen, auf Meldungen reagieren, Anmeldeprobleme lösen, Design wechseln, nach einem Update prüfen"
---

## Neue Instanz in Betrieb nehmen

Eine frisch installierte Plattform startet im [Wartungsmodus](/handbuch/plattform-admin/wartung). So machst du sie in Ruhe startklar und gibst sie am Ende frei:

<Steps>
  <Step title="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](/konfiguration) und [Rechtstexte der Plattform](/handbuch/plattform-admin/rechtstexte)). `MAILER_DSN` darf leer bleiben, wenn du den E-Mail-Versand im Plattform-Admin einrichten willst.
  </Step>
  <Step title="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](/handbuch/plattform-admin/konsole#wartungsmodus)).
  </Step>
  <Step title="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.
  </Step>
  <Step title="Systemstatus prüfen">
    In der [Übersicht](/handbuch/plattform-admin/admin-bereich#übersicht-und-systemstatus) 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.
  </Step>
  <Step title="E-Mail-Versand einrichten">
    Unter [E-Mail-Versand](/handbuch/plattform-admin/email-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.
  </Step>
  <Step title="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.
  </Step>
  <Step title="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`.
  </Step>
  <Step title="Aussehen festlegen">
    Unter [Darstellung](/handbuch/plattform-admin/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.
  </Step>
  <Step title="Links">
    Unter [Links](/handbuch/plattform-admin/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.
  </Step>
  <Step title="Optional: Zahlungen und Push">
    Sollen Owner bezahlte Pläne verkaufen, richtet der Betreiber Stripe ein (siehe [Zahlungen einrichten](/zahlungen)); für Push-Benachrichtigungen braucht es VAPID-Schlüssel (`app:push:keys`).
  </Step>
  <Step title="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](/handbuch/plattform-admin/communities#verzeichnis-der-communities) im Verzeichnis ausblenden.
  </Step>
  <Step title="Wartungsmodus ausschalten">
    Unter [Wartung](/handbuch/plattform-admin/wartung) **Wartungsmodus ausschalten**. Ist `MAINTENANCE_MODE=on` gesetzt, muss der Betreiber die Variable leeren oder auf `off` setzen.
  </Step>
</Steps>

## Weiteren Plattform-Admin hinzufügen

1. Die Person registriert sich normal und bestätigt ihre E-Mail-Adresse.
2. Unter [Nutzer](/handbuch/plattform-admin/nutzer) nach ihrer Adresse suchen und **Zum Admin machen**.
3. 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**.
4. Die Person bitten, die Zwei-Faktor-Anmeldung einzurichten.

Ohne Browser geht dasselbe mit `php bin/console app:user:promote <email> --verify`.

## Auf eine Meldung über eine Community reagieren

1. Unter [Communities](/handbuch/plattform-admin/communities) die Community suchen und den **Owner** (E-Mail in der Liste) informieren.
2. Die Inhalte prüfen – als Plattform-Admin kannst du die Community öffnen, auch wenn sie privat ist.
3. Reicht es, einzelne Beiträge oder Mitglieder zu moderieren, das dem Team der Community überlassen bzw. selbst moderieren.
4. Nur im Notfall **Sperren**. Laufende Abos laufen weiter – das mit dem Owner klären.
5. Nach der Klärung **Freigeben**. Sperre und Freigabe stehen im [Protokoll](/handbuch/plattform-admin/protokoll).

## Jemand kommt nicht in sein Konto

| Problem | Lösung |
| --- | --- |
| Bestätigungsmail kommt nicht | [E-Mail-Versand](/handbuch/plattform-admin/email-versand): Testmail und Status prüfen. Danach ggf. unter [Nutzer](/handbuch/plattform-admin/nutzer) **E-Mail bestätigen**. |
| Passwort vergessen, Mail zum Zurücksetzen kommt nicht | E-Mail-Versand prüfen; notfalls setzt der Betreiber mit `app:user:password <email>` ein neues Passwort und gibt es auf sicherem Weg weiter. |
| Zwei-Faktor-Gerät verloren | Anmeldung mit einem Wiederherstellungscode. Ohne Codes gibt es keinen Weg zurück; das Konto lässt sich nur löschen und neu anlegen. |
| Viele Fehlversuche | Die Anmeldung ist je Konto und Stunde begrenzt; nach Ablauf geht es wieder. |
| Konto gelöscht | Lässt sich nicht wiederherstellen; mit derselben Adresse kann ein neues Konto angelegt werden. |

## Design wechseln, ohne etwas zu verlieren

1. Unter [Darstellung](/handbuch/plattform-admin/darstellung) das bisherige Template sichern: **Herunterladen** (eigene) bzw. **Kopie herunterladen** (mitgelieferte).
2. Neues Template hochladen oder im Theme-Editor erstellen und die **Kontrast**-Prüfung beachten.
3. **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**.
4. 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

1. Die Hinweise zur neuen Version unter [Änderungen](/changelog) und [Updates](/updates) lesen.
2. [Übersicht](/handbuch/plattform-admin/admin-bereich#übersicht-und-systemstatus): Fehlgeschlagene Hintergrundjobs = 0, E-Mail-Versand mit der erwarteten Quelle.
3. Testmail senden und die Startseite sowie eine Community aufrufen.
4. 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.
