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.

So rufst du Befehle auf

Alle Befehle beginnen mit php bin/console. Wo du sie eingibst, hängt von der Installationsart ab: 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.
Werte mit Sonderzeichen wie $, ! oder Leerzeichen stehen in einfachen Anführungszeichen, damit die Shell sie nicht verändert: --password='Mein$icheres!Pw'.

Erststart und Systemprüfung

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

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

Wartungsmodus

Legt MAINTENANCE_MODE bzw. MAINTENANCE_PASSWORD den Wert fest, ändert der Befehl ihn nicht. Mehr unter 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.
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.

Templates

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.

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.
<slug> ist die Adresse der Community, also demo für /c/demo.

Push-Benachrichtigungen

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). 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). 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.

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:

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.
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.

Plugins

Plugins legt der Betreiber als Dateien auf den Server (siehe Plugins installieren); aktivieren kannst du sie unter Plattform-Admin → Plugins oder hier. Auf der Konsole ist keine erneute Anmeldung nötig; das Protokoll vermerkt die Konsole als Herkunft.
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.
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.

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.

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, 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 [email protected] (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.
Die Beispiel-Community ist öffentlich und erscheint im Community-Verzeichnis; ausblenden kannst du sie unter 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). 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:

Bankleitzahlen aktualisieren

Bankname und BIC deutscher Konten für die 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:
Mit --dry-run prüft der Befehl nur. Eine falsche oder abgelaufene Datei lehnt er ab, ohne etwas zu ändern.

Weitere Befehle