Shopware — Die bin/console-Kommandozeile von Shopware 6

Shopware 6 ist ein Symfony-basiertes Open-Source-Shopsystem, das du fast vollständig über die Kommandozeile bin/console steuern kannst. Vom Cache-Leeren über Plugin- und Theme-Verwaltung bis zu Indizierung, Migrationen und Wartungsarbeiten läuft der Betrieb deines Shops über genau diese Befehle. Dieser Guide bündelt die wichtigsten bin/console-Kommandos für Pflege, Deployment und Fehlersuche – von der täglichen Routine bis zum Systemupdate.

Allgemein & Infos

bin/console list — Listet alle verfügbaren Kommandos auf.

bin/console list

bin/console about — Zeigt Versionsinfos zu Shopware und Symfony an.

bin/console about

bin/console system:info — Zeigt Systeminformationen und prüft die Systemvoraussetzungen.

bin/console system:info

bin/console system:config:get <key> — Liest einen Wert aus der Systemkonfiguration aus.

bin/console system:config:get core.basicInformation.shopName

bin/console system:config:set <key> <value> — Setzt einen Wert in der Systemkonfiguration.

bin/console system:config:set core.basicInformation.shopName 'My Shop'

Cache & Build

bin/console cache:clear — Leert den Anwendungs-Cache.

bin/console cache:clear

bin/console cache:warmup — Wärmt den Cache vor.

bin/console cache:warmup

bin/console http:cache:warm:up — Wärmt den HTTP-Cache (Reverse-Proxy) vor.

bin/console http:cache:warm:up

bin/console theme:compile — Kompiliert die Theme-Assets (CSS, JS).

bin/console theme:compile

bin/console theme:refresh — Aktualisiert die Theme-Konfiguration.

bin/console theme:refresh

bin/console theme:dump — Gibt die Theme-Konfiguration zum Debuggen aus.

bin/console theme:dump

bin/console assets:install — Installiert Bundle- und Plugin-Assets ins öffentliche Verzeichnis.

bin/console assets:install

Plugin-Verwaltung

bin/console plugin:list — Listet alle Plugins und ihren Status auf.

bin/console plugin:list

bin/console plugin:install <name> — Installiert ein Plugin.

bin/console plugin:install MyPlugin

bin/console plugin:install --activate <name> — Installiert und aktiviert ein Plugin in einem Schritt.

bin/console plugin:install --activate MyPlugin

bin/console plugin:activate <name> — Aktiviert ein installiertes Plugin.

bin/console plugin:activate MyPlugin

bin/console plugin:deactivate <name> — Deaktiviert ein Plugin.

bin/console plugin:deactivate MyPlugin

bin/console plugin:update <name> — Aktualisiert ein Plugin.

bin/console plugin:update MyPlugin

bin/console plugin:uninstall <name> — Deinstalliert ein Plugin.

bin/console plugin:uninstall MyPlugin

bin/console plugin:refresh — Aktualisiert die Plugin-Liste (erkennt neue Plugins).

bin/console plugin:refresh

Indizierung & Daten

bin/console dal:refresh:index — Baut den Index des Data Abstraction Layer neu auf.

bin/console dal:refresh:index

bin/console es:index — Indiziert Elasticsearch / OpenSearch neu.

bin/console es:index

bin/console es:reset — Setzt die Elasticsearch-Indizes zurück und legt sie neu an.

bin/console es:reset

bin/console es:status — Zeigt den Status des Elasticsearch-Index an.

bin/console es:status

bin/console product:index — Indiziert Produkte neu (Varianten-Listing, günstigster Preis usw.).

bin/console product:index

bin/console media:generate-thumbnails — Erzeugt Thumbnails für alle Mediendateien.

bin/console media:generate-thumbnails

bin/console media:delete-unused — Löscht Mediendateien, die nirgends referenziert sind.

bin/console media:delete-unused

Benutzer & Verkaufskanäle

bin/console user:create <username> — Legt einen neuen Admin-Benutzer an.

bin/console user:create admin --admin --email=admin@example.com --password=secret

bin/console user:change-password <username> — Ändert das Passwort eines Admin-Benutzers.

bin/console user:change-password admin

bin/console user:list — Listet alle Admin-Benutzer auf.

bin/console user:list

bin/console sales-channel:list — Listet alle Verkaufskanäle auf.

bin/console sales-channel:list

bin/console sales-channel:create:storefront — Legt einen neuen Storefront-Verkaufskanal an.

bin/console sales-channel:create:storefront --name='My Store' --url='https://myshop.com'

bin/console sales-channel:maintenance:toggle <id> — Schaltet den Wartungsmodus eines Verkaufskanals um.

bin/console sales-channel:maintenance:toggle <sales-channel-id>

Queue & geplante Tasks

bin/console messenger:consume async — Verarbeitet Nachrichten aus der Async-Queue.

bin/console messenger:consume async --time-limit=60

bin/console messenger:consume async --limit=<n> — Verarbeitet eine begrenzte Anzahl an Nachrichten.

bin/console messenger:consume async --limit=50

bin/console messenger:failed:show — Zeigt fehlgeschlagene Nachrichten an.

bin/console messenger:failed:show

bin/console messenger:failed:retry — Wiederholt alle fehlgeschlagenen Nachrichten.

bin/console messenger:failed:retry

bin/console scheduled-task:run — Führt alle fälligen geplanten Tasks aus.

bin/console scheduled-task:run

bin/console scheduled-task:list — Listet alle registrierten geplanten Tasks und ihren Status auf.

bin/console scheduled-task:list

Setup & Wartung

bin/console system:setup — Interaktives System-Setup (Datenbank, URL usw.).

bin/console system:setup

bin/console system:install — Installiert Shopware (legt das Datenbankschema an, importiert Basisdaten).

bin/console system:install --basic-setup

bin/console system:update:prepare — Bereitet das System auf ein Update vor (aktiviert den Wartungsmodus).

bin/console system:update:prepare

bin/console system:update:finish — Schließt den Update-Vorgang ab (deaktiviert den Wartungsmodus).

bin/console system:update:finish

bin/console database:migrate --all — Führt alle ausstehenden Datenbankmigrationen aus.

bin/console database:migrate --all

bin/console database:migrate-destructive --all — Führt destruktive Migrationen aus (Spalten löschen usw.).

bin/console database:migrate-destructive --all

bin/console sitemap:generate — Erzeugt XML-Sitemaps für alle Verkaufskanäle.

bin/console sitemap:generate

bin/console debug:router — Listet alle registrierten Routen auf.

bin/console debug:router

Fazit

Mit bin/console hast du den gesamten Lebenszyklus eines Shopware-6-Shops in der Hand: Cache und Themes neu aufbauen, Plugins verwalten, Indizes pflegen und Updates fahren. Für den Alltag bilden cache:clear, theme:compile und dal:refresh:index das Rückgrat – sie laufen nach fast jeder Konfigurations- oder Code-Änderung.

Bei allem, was die Datenbank oder das System verändert, gilt Vorsicht: database:migrate, database:migrate-destructive und system:update:* solltest du nur mit einem frischen Backup ausführen, denn destruktive Migrationen löschen Spalten unwiderruflich. Aktiviere vor Migrationen über system:update:prepare oder den Verkaufskanal-Wartungsmodus den Wartungszustand, damit dir keine Kunden in eine halb migrierte Datenbank laufen. system:setup schreibt deine .env und überschreibt vorhandene Zugangsdaten – prüfe vorher, was bereits konfiguriert ist.

Weiterführende Links

Shopware Developer Documentation – offizielle Entwickler-Doku mit CLI- und Konsolen-Referenz (englisch)
shopware.com – Herstellerseite mit Produkt- und Editionsinfos (deutsch)