---
title: "Konsolenbefehle für Betreiber"
description: "Befehle auf dem Server mit Beispielen: Erststart, Systemprüfung, Konten, Wartungsmodus, E-Mail, Templates, Zahlungen, Push, Punkte, externe Feeds, Plugins und Beispiel-Community"
---

Manches geht nicht über die Oberfläche, sondern nur auf dem Server – etwa solange noch kein E-Mail-Versand eingerichtet ist, wenn du dein Passwort oder das Zugangswort vergessen hast oder für automatische Abläufe. Diese Befehle führt der **Betreiber** im App-Container bzw. im Anwendungsverzeichnis aus. Diese Seite erklärt sie mit Beispielen; die knappe Referenz steht unter [Betrieb → Konsole](/betrieb#konsole).

## So rufst du Befehle auf

Alle Befehle beginnen mit `php bin/console`. Wo du sie eingibst, hängt von der Installationsart ab:

| Installation | Aufruf |
| --- | --- |
| Docker Compose | `docker compose exec app php bin/console <befehl>` im Verzeichnis der Compose-Datei |
| Portainer | Containers → `<stack>-app-1` → **Console** (`/bin/sh`, Benutzer `www-data`), dann `php bin/console <befehl>` |
| Coolify | Ressource → Dienst `app` → **Terminal**, dann `php bin/console <befehl>` |
| Webserver ohne Docker | `cd /var/www/quicktribe/current && runuser -u www-data -- php bin/console <befehl>` |

In den Beispielen unten steht nur der Teil ab `php bin/console`. `php bin/console list app` zeigt alle Befehle von QuickTribe, `php bin/console <befehl> --help` die Optionen eines Befehls.

<Tip>
Werte mit Sonderzeichen wie `$`, `!` oder Leerzeichen stehen in einfachen Anführungszeichen, damit die Shell sie nicht verändert: `--password='Mein$icheres!Pw'`.
</Tip>

## Erststart und Systemprüfung

| Befehl | Zweck |
| --- | --- |
| `app:install` | Erststart: legt aus `ADMIN_EMAIL` und `ADMIN_PASSWORD` (mindestens 12 Zeichen) den ersten, bestätigten Plattform-Admin an – nur, wenn noch kein Konto existiert. Schaltet auf einer leeren Installation den [Wartungsmodus](/handbuch/plattform-admin/wartung) ein und gibt das Zugangswort aus. Läuft bei Docker-Installationen automatisch im Container `migrate`; mehrfaches Ausführen schadet nicht. |
| `app:doctor` | Systemprüfung: Geheimnisse, Datenbank, Redis, Speicher, E-Mail-Versand (mit aktiver Quelle), Stripe (API-Version und Weg der Ereignisse), Lastschrift (Bankleitzahlendatei der Bundesbank, Gläubiger je Community) und Plugins. Meldet jedes Problem mit Hinweis; Zeilen mit „!“ sind Hinweise, keine Fehler. |

```bash
php bin/console app:install
php bin/console app:doctor
```

`app:install` meldet je nach Lage „Plattform-Admin … angelegt“, „Es existieren bereits Konten – ADMIN_EMAIL wird ignoriert.“ oder „ADMIN_EMAIL/ADMIN_PASSWORD nicht gesetzt – kein Konto angelegt.“ Nach dem ersten Konto kannst du beide Variablen aus der Konfiguration entfernen.

## Konten verwalten

| Befehl | Zweck |
| --- | --- |
| `app:user:list [--deleted] [--limit=200]` | Konten mit E-Mail, Name, bestätigt, Plattform-Admin und Anlagedatum; `--deleted` zeigt auch gelöschte |
| `app:user:promote <email> [--verify]` | Zum Plattform-Admin machen; `--verify` bestätigt die E-Mail-Adresse gleich mit |
| `app:user:password <email> [--password=…]` | Neues Passwort setzen (mindestens 10 Zeichen). Ohne `--password` wird ein zufälliges Passwort mit 16 Zeichen erzeugt und **einmalig** angezeigt |
| `app:user:delete <email> [-y]` | Konto löschen (anonymisieren) wie beim Selbstlöschen; Owner einer Community werden abgelehnt. Ohne `-y` fragt der Befehl nach |

```bash
# Weiteres Konto ohne Mailversand zum Plattform-Admin machen
php bin/console app:user:promote anna@example.org --verify

# Passwort vergessen, kein E-Mail-Versand: neues Passwort erzeugen lassen
php bin/console app:user:password anna@example.org

# Konto auf Wunsch löschen, ohne Rückfrage
php bin/console app:user:delete alt@example.org -y
```

<Warning>
Setze Passwörter nie direkt in der Datenbank. `app:user:password` speichert sie korrekt verschlüsselt; ein von Hand eingetragener Wert funktioniert nicht.
</Warning>

## Wartungsmodus

```bash
php bin/console app:maintenance                    # Zustand und Zugangswort anzeigen
php bin/console app:maintenance on                 # einschalten
php bin/console app:maintenance off                # ausschalten
php bin/console app:maintenance new                # neues zufälliges Wort
php bin/console app:maintenance set lighthouse-42  # eigenes Wort (8 bis 64 Zeichen)
```

Legt `MAINTENANCE_MODE` bzw. `MAINTENANCE_PASSWORD` den Wert fest, ändert der Befehl ihn nicht. Mehr unter [Wartung](/handbuch/plattform-admin/wartung).

## E-Mail prüfen

`app:mail:test <email>` verschickt sofort – ohne den Hintergrunddienst – eine Testmail über den gerade gültigen Zugang (`MAILER_DSN` oder Plattform-Admin → E-Mail-Versand) und nennt bei Fehlern die Ursache: Anmeldung abgelehnt, Server nicht erreichbar, Verschlüsselung, Zeitüberschreitung, Absender abgelehnt.

```bash
php bin/console app:mail:test admin@example.org
```

Mails, die im Hintergrund endgültig gescheitert sind, zeigt `php bin/console messenger:failed:show`; nach dem Beheben verschickt `php bin/console messenger:failed:retry` sie erneut. Nach sieben Tagen werden sie gelöscht. Siehe [E-Mail-Versand](/handbuch/plattform-admin/email-versand).

## Templates

| Befehl | Zweck |
| --- | --- |
| `app:theme:list` | Templates auflisten – Schlüssel (das aktive mit `*`), Name, Herkunft, Version, Upload und Zahl der archivierten Fassungen |
| `app:theme:validate <zip> [--key=…]` | Paket prüfen, ohne es zu übernehmen – listet alle Fehler mit Datei und Zeile |
| `app:theme:import <zip> [--key=…] [--activate]` | Paket hochladen bzw. als neue Fassung einspielen; `--activate` wählt es gleich aus |
| `app:theme:export <key> <ziel.zip> [--as=…]` | Template als ZIP speichern; mitgelieferte als Kopie mit dem Schlüssel `mein-<key>` bzw. dem aus `--as` |

```bash
php bin/console app:theme:validate /tmp/mein-theme.zip
php bin/console app:theme:import /tmp/mein-theme.zip --activate
php bin/console app:theme:export mitternacht /tmp/mitternacht-kopie.zip --as=unser-design
```

Bei Docker-Installationen muss die ZIP-Datei im Container liegen, z. B. mit `docker compose cp mein-theme.zip app:/tmp/`. Details unter [Theme installieren](/anpassen/theme-installieren).

## Zahlungen nachholen

`app:billing:sync <slug> [--limit=50]` holt verpasste Stripe-Ereignisse einer Community nach – etwa wenn die Ereignisse von Stripe (Event Destination bzw. Webhook) oder der Hintergrunddienst nicht ankamen: archiviert die jüngsten Rechnungen (Standard 50, höchstens 100) und ordnet sie Plänen und Kursen zu, gleicht Abos samt Zahlungsstatus ab und aktualisiert den Rechnungsfuß bei allen Stripe-Kunden. Gutschriften holt er nicht nach.

```bash
php bin/console app:billing:sync demo --limit=100
```

`<slug>` ist die Adresse der Community, also `demo` für `/c/demo`.

## Push-Benachrichtigungen

```bash
php bin/console app:push:keys                     # VAPID-Schlüsselpaar erzeugen
php bin/console app:push:test anna@example.org    # Test-Push an alle Geräte des Kontos (über den Worker)
php bin/console app:push:test anna@example.org --direct   # sofort senden, Ergebnis je Gerät
```

`app:push:keys` gibt `PUSH_VAPID_PUBLIC_KEY` und `PUSH_VAPID_PRIVATE_KEY` aus; trage sie mit `PUSH_VAPID_SUBJECT` in die Konfiguration ein (siehe [Konfiguration](/konfiguration#push-benachrichtigungen)). `app:push:test` stellt die Nachricht in die Warteschlange, der Hintergrunddienst verschickt sie an alle Geräte, die das Konto unter Profil → Push-Benachrichtigungen angemeldet hat. Ob es geklappt hat, zeigen das Log des Workers und „zuletzt zugestellt“ beim Gerät. Mit `--direct` sendet der Befehl ohne Worker und zeigt je Gerät, ob der Push-Dienst die Mitteilung angenommen hat, ob das Abo abgelaufen war (es wird entfernt) oder warum er abgelehnt hat – dasselbe Ergebnis wie **Test-Benachrichtigung senden** in den Kontoeinstellungen des Nutzers (siehe [Push testen und Probleme lösen](/handbuch/mitglieder/benachrichtigungen#push-testen-und-probleme-lösen)). Meldet er „Der Server erreicht den Push-Dienst nicht“, darf der Server keine ausgehenden HTTPS-Verbindungen zu den Push-Diensten aufbauen (Firewall, Proxy). Weitere Fehlerbilder: [Betrieb → Push-Benachrichtigungen prüfen](/betrieb#push-benachrichtigungen-prüfen).

## Punkte korrigieren

`app:points:adjust <slug> <email> <delta> [--note=…]` schreibt eine manuelle Buchung ins Punktekonto eines Mitglieds und berechnet Punkte und Level neu. Negative Werte brauchen `--` davor, damit sie nicht als Option gelten:

```bash
php bin/console app:points:adjust demo mia@example.org 25 --note="Workshop geleitet"
php bin/console app:points:adjust demo mia@example.org -- -5
```

## Externe Feeds prüfen

`app:feed:fetch <url> [--user=…] [--link-host=…] [--limit=10]` ruft einen Atom- oder RSS-Feed probeweise ab – mit denselben Regeln wie im Betrieb, einschließlich `APP_FEED_ALLOWED_HOSTS` – und zeigt die übernommenen Einträge mit Textlänge und die erkannten Threads. Gespeichert wird nichts. Das Passwort für eine HTTP-Anmeldung kommt aus der Umgebungsvariable `FEED_PASSWORD` oder wird verdeckt abgefragt.

```bash
php bin/console app:feed:fetch https://forum.example.org/app.php/feed/topics
FEED_PASSWORD='geheim' php bin/console app:feed:fetch https://forum.example.org/app.php/feed --user=feedleser
```

Bei Docker Compose gibst du das Passwort mit `docker compose exec -e FEED_PASSWORD='geheim' app php bin/console app:feed:fetch …` mit. Wie Owner Feeds einrichten, steht unter [Feeds](/handbuch/owner/feeds).

## Plugins

Plugins legt der Betreiber als Dateien auf den Server (siehe [Plugins installieren](/plugins/installieren)); aktivieren kannst du sie unter [Plattform-Admin → Plugins](/handbuch/plattform-admin/plugins) oder hier. Auf der Konsole ist keine erneute Anmeldung nötig; das Protokoll vermerkt die Konsole als Herkunft.

```bash
php bin/console app:plugin:list                                  # Übersicht mit Status
php bin/console app:plugin:validate                              # alle Plugins prüfen (Exit-Code 1 bei Fehlern)
php bin/console app:plugin:enable mein-plugin                    # plattformweit aktivieren, legt die Tabellen an
php bin/console app:plugin:enable mein-plugin --community=demo   # zusätzlich in /c/demo einschalten
php bin/console app:plugin:migrate --enabled --strict            # offene Migrationen aller aktiven Plugins nachholen
php bin/console app:plugin:disable mein-plugin --community=demo  # in einer Community ausschalten
php bin/console app:plugin:disable mein-plugin                   # plattformweit deaktivieren (Daten bleiben)
```

`app:plugin:list` zeigt je Plugin ID, Name, Version, Status, die Zahl der Communities, in denen es eingeschaltet ist, und den ersten Hinweis – etwa den Grund für „unsicher“ oder die Meldung einer gescheiterten Migration. Was die Zustände bedeuten und was bei Fehlern hilft, steht unter [Plugins betreiben](/plugins/betrieb#fehlersuche).

<Warning>
`app:plugin:migrate --fresh` löscht vorher Plugin-Tabellen samt Daten – mit `--all` die **aller** Plugins, mit einer Plugin-ID oder `--enabled` die dieser Plugins – und ist nur für Entwicklung und Tests gedacht. In Produktion verweigert der Befehl das ohne `--force` – verwende ihn dort nicht.
</Warning>

## Beispiel-Community anlegen

`app:demo:seed --owner=<email>` legt eine eigene, öffentliche Beispiel-Community mit erfundenen Inhalten an – zum Ausprobieren, für Schulungen oder ein Testsystem. Sie enthält rund 40 Mitglieder, Beiträge mit Kommentaren und Reaktionen, eine Umfrage, wiederkehrende Termine ohne Ende (wöchentlich, jeden 1. Sonntag, jeden 3. Montag, jeden letzten Montag), je einen Einzeltermin in jedem der nächsten sechs Monate (darunter ein Fest mit Warteliste), zwei Kurse mit einem laufenden Durchgang, ein Wiki, Nachrichten, Level und eine monatliche Challenge.

| Option | Zweck |
| --- | --- |
| `--owner=<email>` | Ein bestehendes Konto, das Owner der Beispiel-Community wird – Pflicht, außer mit Demo-Logins (dann ist das Konto `vorstand@…` Owner) |
| `--demo-profile=<profil>` | Inhalte: `standard` (Breitensportverein, ohne Angabe), `schuetzenverein` („Schützenverein Musterhausen 1888 e.V.“) oder `reitverein` („Reit- und Fahrverein Mustertal e.V.“), beide mit Demo-Logins. `--refresh` ergänzt immer mit dem Profil der Anlage |
| `--logins` / `--no-logins` | Anmeldefähige Demo-Konten je Rolle anlegen (nur Profile `schuetzenverein` und `reitverein`, dort Standard) |
| `--slug=<adresse>` | Adresse der Community, Standard je Profil `beispiel-verein`, `sv-musterhausen` bzw. `rv-mustertal` |
| `--name=<name>` | Name der Community, Standard aus dem Profil |
| `--members=<anzahl>` | Anzahl der erfundenen Mitglieder, 8 bis 200, Standard 40, im Profil `schuetzenverein` 64, im Profil `reitverein` 56 |
| `--seed=<zahl>` | Gleiche Zahl ergibt wieder dieselben Mitglieder, Beiträge, Termine und Zusagen – nützlich für Tests und Fehlersuche. Alle Zeitpunkte richten sich nach dem Zeitpunkt des Laufs. Ohne Angabe zufällig (die Ausgabe nennt den Wert) |
| `--refresh` | Eine mit diesem Befehl angelegte Community ergänzen: neue kommende Termine, Zusagen für die nächsten Wochen (nach einer längeren Pause auch für die Termine dazwischen), bei Bedarf ein neuer Kursdurchgang sowie einige Beiträge, Kommentare und Punkte im laufenden Monat. Löscht nichts und legt keine Mitglieder an |

```bash
php bin/console app:demo:seed --owner=admin@example.org
php bin/console app:demo:seed --owner=admin@example.org --refresh   # z. B. einmal im Monat
php bin/console app:demo:seed --demo-profile=schuetzenverein         # Schützenverein mit Demo-Logins
php bin/console app:demo:seed --demo-profile=schuetzenverein --refresh
php bin/console app:demo:seed --demo-profile=reitverein              # Reitverein mit Demo-Logins
```

### Profil Schützenverein und Demo-Logins

Das Profil `schuetzenverein` legt einen erfundenen Schützenverein an: rund 70 Mitglieder (darunter Jugendliche ab 12),
eigene Rollen „Vorstand“, „Schießleiter“, „Standaufsicht“, „Jugendleiter“, „Kasse“, „Theke“ und „Waffenwart“,
Beitragsklassen als vergebene kostenlose Pläne (Erwachsene, Jugend, Familie, Passiv – ohne Zahlungsabwicklung), Trainings
für Luftdruck, Kleinkaliber/Großkaliber, Jugend (nur unter 18) und Bogen, Rundenwettkämpfe auswärts, Jahrestermine wie
Königsschießen und Schützenfest, passende Beiträge, Kurse und ein Wiki mit Standordnung.

Dazu kommen acht **Demo-Logins**, mit denen du die Community aus Sicht jeder Rolle zeigen kannst:
`vorstand@` (Owner), `schiessleiter@` (Admin), `aufsicht@`, `jugendleiter@` (Moderator), `kasse@`, `theke@`,
`mitglied@` und `jugend@` (15 Jahre), jeweils `@musterhausen.demo.invalid`. Alle nutzen ein gemeinsames Zufallspasswort,
das der Befehl **nur bei der Anlage einmal** anzeigt – notiere es dir. `--refresh` ändert es nicht; zurücksetzen kannst du
es je Konto mit `app:user:password <email>`. An diese Adressen geht nie eine E-Mail. Gibt es die Konten schon (etwa von
einer früheren, gelöschten Beispiel-Community), bricht der Befehl ab; entferne sie dann mit `app:user:delete` oder lege die
Community mit `--no-logins --owner=…` an.

### Profil Reitverein

Das Profil `reitverein` legt den erfundenen „Reit- und Fahrverein Mustertal e.V.“ an und zeigt, wie ein Reitverein die
Plattform nutzt:

- **Reitstunden mit begrenzten Plätzen:** Abteilungsreiten auf acht Schulpferden und die Dressurstunde haben feste
  Plätze mit Warteliste – wer zusagt, hat sein Pferd, alle anderen rücken nach. Zusagen des Teams belegen keinen Platz
  (die Reitlehrerin sagt zu ihrer Stunde zu, ohne ein Schulpferd zu blockieren).
- **Dienste:** „Arbeitseinsatz“ (4 im Jahr), „Stalldienst“ (3) und „Turnierhelfer“ (2). Der Stalldienst am Sonntag ist
  ein Dienst-Termin, die Springstunde hat die Aufgabe „Parcoursaufbau“, die Reitertage haben „Meldestelle“,
  „Parcoursdienst“ und „Kuchentheke“ zum Eintragen.
- **Termine rund ums Pferd:** Voltigieren (nur unter 18), Ausritt am ersten Sonntag, Turniere auswärts, Sammeltermin
  Impfung, Hufschmied mit acht Plätzen, Lehrgang Reitabzeichen, Ferienreittag, Reiterball mit Tickets und Warteliste.
- **Rollen und Mitgliedsarten:** „Vorstand“, „Reitlehrer“, „Jugendwart“, „Sportwart“, „Kasse“, „Stallmeister“ und
  „Einsteller“; Mitglieder sehen „Mitgliedsart“ statt „Plan“ (Erwachsene, Jugend, Familie, Fördermitglied – vergeben,
  ohne Zahlungsabwicklung). Die Startseite zeigt keinen Preis, der Kalender steht im Menü weit vorn, und die Community
  trägt das mitgelieferte Template „Reiterhof“.
- **Kurse und Wiki:** „Theorie fürs Reitabzeichen“ (mit Durchgang), „Erste Hilfe am Pferd“ (ab 18, mit Bescheinigung),
  „Stallführerschein“ (unter 18, mit Urkunde); im Wiki das Stallhandbuch mit Reit- und Hallenordnung, Stallordnung,
  Arbeitsstunden, Notfall und Impfungen.

Die neun Demo-Logins lauten `vorstand@` (Owner), `reitlehrer@` (Admin), `jugendwart@` (Moderator), `sportwart@`,
`kasse@`, `stall@`, `einsteller@`, `jugend@` (14 Jahre) und `mitglied@`, jeweils `@mustertal.demo.invalid`. Für Passwort
und vorhandene Konten gilt dasselbe wie beim Schützenverein.

Gibt es die Adresse schon, bricht der Befehl ab – bestehende Communities verändert er nie, auch nicht mit `--refresh`. Aktive [Plugins](/plugins/ueberblick), die je Community gelten, schaltet der Befehl in seiner Beispiel-Community ein und lässt sie eigene Beispieldaten anlegen; die Ausgabe nennt je Plugin das Ergebnis (`ok`, `skipped`, `failed`). Bei `--refresh` kommen nur neu hinzugekommene Plugins dazu – eines, das du dort ausgeschaltet hast, bleibt aus. Ein Profil kann Plugins auslassen, die nicht zum Verein passen; die Ausgabe nennt sie, und du kannst sie in der Community von Hand einschalten. Die Beispiel-Mitglieder haben Adressen der Form `name@demo.invalid` (Demo-Logins `…@musterhausen.demo.invalid` bzw. `…@mustertal.demo.invalid`), an die nie etwas verschickt wird. Der Befehl selbst löst keine E-Mails, Benachrichtigungen oder Push-Mitteilungen aus. Am Ende zeigt er je Bereich, wie viel angelegt wurde, und das Protokoll unter Plattform-Admin → Protokoll erhält einen Eintrag `community.demo_seeded`.

Danach läuft die Beispiel-Community wie jede andere: Der geplante Beitrag erscheint nach drei Tagen, Geburtstage tauchen im Feed auf, Teilnahme-Punkte und der Monatsabschluss der Challenge kommen automatisch. Wer neue Beiträge der Community abonniert hat – etwa du als Owner –, bekommt dabei die üblichen Benachrichtigungen.

<Note>
Die Beispiel-Community ist öffentlich und erscheint im Community-Verzeichnis; ausblenden kannst du sie unter [Plattform-Admin → Communities](/handbuch/plattform-admin/communities). Gab es bisher nur eine Community, leitet die Startseite `/` nicht mehr direkt dorthin weiter, sondern zeigt die Übersicht der Communities – bis die Beispiel-Community wieder gelöscht ist.

Löschen kann sie nur ihr Owner unter **Einstellungen → Übergabe und Löschen** (siehe [Übergabe und Löschen](/handbuch/owner/uebergabe-loeschen)). Ihre Adresse bleibt danach belegt – eine neue Beispiel-Community braucht dann ein anderes `--slug`. Die Beispiel-Konten (`…@demo.invalid`, auch die Demo-Logins) bleiben ebenfalls bestehen und erscheinen in der Nutzerliste; du entfernst sie mit `app:user:delete`:

```bash
php bin/console app:user:list --limit=1000 | grep -oE '[^ ]+@([a-z0-9-]+\.)?demo\.invalid' | xargs -n1 php bin/console app:user:delete -y
```
</Note>

## Bankleitzahlen aktualisieren

Bankname und BIC deutscher Konten für die [Lastschrift](/lastschrift) kommen aus der Bankleitzahlendatei der Bundesbank, die jedem Release beiliegt. Meldet `app:doctor` sie als abgelaufen und steht kein Update an, spielst du die aktuelle Datei selbst ein – heruntergeladen im TXT-Format von der Bundesbank, die Gültigkeit steht auf der Download-Seite:

```bash
docker compose cp blz-aktuell-txt-data.txt app:/tmp/blz.txt
docker compose exec app php bin/console app:bank:import-blz /tmp/blz.txt --valid-from=07.12.2026 --valid-until=07.03.2027
```

Mit `--dry-run` prüft der Befehl nur. Eine falsche oder abgelaufene Datei lehnt er ab, ohne etwas zu ändern.

## Weitere Befehle

| Befehl | Zweck |
| --- | --- |
| `app:link-preview:fetch <url> [<slug>]` | Link-Vorschau einer Adresse testweise abrufen, ohne zu speichern |
| `messenger:failed:show`, `messenger:failed:retry` | Gescheiterte Hintergrundjobs anzeigen bzw. erneut versuchen (die Zahl steht in der [Übersicht](/handbuch/plattform-admin/admin-bereich#übersicht-und-systemstatus)) |
