Drush für Profis: Drupal-Verwaltung über die Kommandozeile (CLI)

Drupal effizient über die Kommandozeile verwalten

Drupal lässt sich vollständig über die Administrationsoberfläche bedienen. Für viele alltägliche Aufgaben ist das Backend auch der richtige Ort: Inhalte bearbeiten, Benutzer verwalten, Menüs anpassen oder einfache Konfigurationen ändern. Sobald eine Drupal-Website jedoch professionell betrieben, regelmässig aktualisiert oder entwickelt wird, ist die Kommandozeile deutlich schneller und zuverlässiger. Genau dafür gibt es Drush.

Drush steht für Drupal Shell und ist ein Kommandozeilenwerkzeug speziell für Drupal. Mit Drush können Administratoren und Entwickler typische Wartungs-, Entwicklungs- und Diagnoseaufgaben direkt im Terminal ausführen. Dazu gehören Cache-Rebuilds, Datenbankupdates, Statusabfragen, Konfigurations-Exporte, das Aktivieren oder Deinstallieren von Modulen, Cron-Läufe, Benutzerverwaltung und viele weitere Aufgaben.

Der grosse Vorteil: Statt sich durch mehrere Backend-Seiten zu klicken, führen Sie einen Befehl aus und erhalten sofort ein Ergebnis. Besonders bei Updates, Fehlersuche, Deployment-Prozessen und wiederkehrenden Wartungsarbeiten spart Drush viel Zeit. Für Agenturen, Entwickler und fortgeschrittene Website-Betreiber gehört Drush deshalb zu den wichtigsten Werkzeugen im Drupal-Umfeld.

Was ist Drush?

Drush ist kein normales Drupal-Modul, das Sie im Backend aktivieren. Es handelt sich um ein separates Kommandozeilen-Tool, das innerhalb Ihres Drupal-Projekts installiert und über das Terminal ausgeführt wird. Moderne Drupal-Projekte werden in der Regel mit Composer verwaltet. Drush wird dabei ebenfalls als Composer-Abhängigkeit im Projekt installiert.

Wenn Drush korrekt eingerichtet ist, können Sie Befehle wie diese ausführen:

Je nach Serverkonfiguration und Pfad-Einstellungen kann der Befehl auch direkt als drush verfügbar sein. Auf vielen Hosting-Umgebungen ist jedoch die projektspezifische Ausführung über vendor/bin/drush die sauberere und nachvollziehbarere Variante.

Wann ist Drush sinnvoll?

Drush lohnt sich besonders dann, wenn Sie eine Drupal-Website nicht nur gelegentlich bearbeiten, sondern technisch betreuen. Für einfache Inhaltsänderungen ist Drush nicht notwendig. Für Wartung, Entwicklung und professionelle Administration ist es dagegen ein grosser Effizienzgewinn.

Typische Einsatzbereiche sind:

• Cache leeren und neu aufbauen: Sehr nützlich nach Theme-Anpassungen, Moduländerungen oder Konfigurationsänderungen.
• Datenbankupdates ausführen: Wichtig nach Updates von Drupal Core oder Modulen.
• Systemstatus prüfen: Schnelle Kontrolle von Drupal-Version, Datenbank, PHP, Site-URI und Pfaden.
• Cron ausführen: Geplante Drupal-Aufgaben manuell starten.
• Module aktivieren oder deinstallieren: Besonders praktisch in Entwicklungs- und Staging-Umgebungen.
• Konfiguration exportieren und importieren: Wichtig für Deployment-Workflows zwischen Entwicklungs-, Test- und Live-System.
• Benutzer verwalten: Zum Beispiel Passwort zurücksetzen oder Einmal-Login-Link erzeugen.
• Automatisierung: Drush-Befehle können in Skripten, Deployment-Prozessen oder Wartungsabläufen genutzt werden.

Wer Drupal nur als Redakteur nutzt, benötigt Drush in der Regel nicht. Wer Drupal installiert, wartet, erweitert oder für Kundenprojekte betreibt, sollte Drush kennen.

Voraussetzungen bei CURIAWEB

Damit Sie Drush nutzen können, benötigen Sie Zugriff auf die Kommandozeile Ihres Hosting-Pakets. Bei CURIAWEB erfolgt dies über SSH-Zugriff. SSH erlaubt Ihnen, sich sicher mit dem Server zu verbinden und dort Befehle auszuführen.

Für den produktiven Einsatz von Drush sollten folgende Voraussetzungen erfüllt sein:

• aktiver SSH-Zugriff,
• eine Drupal-Installation, die mit Composer verwaltet wird,
• eine passende PHP-Version gemäss Drupal- und Drush-Anforderungen,
• Composer-Zugriff im Projektverzeichnis,
• ausreichende Benutzerrechte für Dateien, Verzeichnisse und Datenbankzugriff,
• Kenntnis des Projektpfads Ihrer Drupal-Installation.

Auf Shared-Hosting-Umgebungen müssen Sie besonders darauf achten, dass der richtige PHP-CLI-Binary verwendet wird. Die PHP-Version im Webserver und die PHP-Version in der Kommandozeile können sich unterscheiden. Wenn Drush unerwartete Fehler ausgibt, ist die PHP-CLI-Version deshalb einer der ersten Punkte, die geprüft werden sollten.

Drush installieren

Bei modernen Drupal-Websites wird Drush üblicherweise direkt im Projekt per Composer installiert. Wechseln Sie dazu per SSH in das Hauptverzeichnis Ihres Drupal-Projekts. Das ist das Verzeichnis, in dem sich die Datei composer.json befindet.

Nach der Installation befindet sich Drush normalerweise im Verzeichnis vendor/bin/. Sie können die Installation mit folgendem Befehl prüfen:

Wenn eine Drush-Version ausgegeben wird, ist das Tool grundsätzlich verfügbar. Anschliessend können Sie mit vendor/bin/drush status prüfen, ob Drush Ihre Drupal-Installation korrekt erkennt.

Drush aus dem richtigen Verzeichnis ausführen

Viele Drush-Probleme entstehen, weil der Befehl im falschen Verzeichnis ausgeführt wird. Drush muss die Drupal-Installation erkennen können. Wechseln Sie deshalb zuerst in das Projektverzeichnis, in dem sich die composer.json befindet. Bei Composer-basierten Drupal-Installationen liegt der öffentliche Webroot häufig in einem Unterordner wie web oder docroot. Das Projektverzeichnis liegt dann eine Ebene darüber.

Ein typischer Aufbau sieht so aus:

In diesem Beispiel führen Sie Drush aus dem Verzeichnis /home/benutzer/drupal-projekt/ aus:

Wenn Sie sich im falschen Verzeichnis befinden, kann Drush die Website möglicherweise nicht vollständig bootstrappen. Dann erscheinen Fehlermeldungen, obwohl Drush korrekt installiert ist.

Die wichtigsten Drush-Befehle im Überblick

Drush besitzt sehr viele Befehle. Für die tägliche Arbeit reichen jedoch einige Kernbefehle, die Sie sicher beherrschen sollten. Die folgende Übersicht zeigt besonders häufig genutzte Befehle.

Viele Drush-Befehle besitzen Kurzformen. So ist drush cr die bekannte Kurzform für Cache Rebuild. Trotzdem ist es sinnvoll, auch die Langformen zu kennen, weil sie oft selbsterklärender sind und in Dokumentationen häufiger verwendet werden.

Cache mit Drush neu aufbauen

Der wahrscheinlich am häufigsten genutzte Drush-Befehl ist der Cache-Rebuild:

Dieser Befehl leert und baut die Drupal-Caches neu auf. Das ist notwendig oder hilfreich, wenn Änderungen nicht sichtbar werden, neue Konfigurationen greifen sollen oder nach Modul- und Theme-Anpassungen ein inkonsistenter Zustand entsteht.

Ein Cache-Rebuild ist grundsätzlich ein sicherer Befehl, kann aber kurzfristig zu höherer Serverlast führen, weil Drupal die Caches danach neu aufbauen muss. Auf stark frequentierten Live-Websites sollte er deshalb bewusst eingesetzt werden, besonders während Lastspitzen.

Datenbankupdates mit Drush ausführen

Nach Updates von Drupal Core oder installierten Modulen können Datenbankupdates erforderlich sein. Diese lassen sich über das Backend mit update.php oder über Drush ausführen. Der Drush-Befehl lautet:

Je nach Drush-Version ist auch die Kurzform drush updb gebräuchlich. Vor diesem Befehl sollten Sie unbedingt ein Backup erstellen. Datenbankupdates verändern die Struktur oder Inhalte der Datenbank und lassen sich nicht immer einfach rückgängig machen.

Ein sicherer Ablauf sieht so aus:

1. Vollständiges Backup von Dateien und Datenbank erstellen.
2. Website in den Wartungsmodus versetzen.
3. Code-Updates per Composer durchführen.
4. Datenbankupdates mit vendor/bin/drush updatedb ausführen.
5. Cache mit vendor/bin/drush cr neu aufbauen.
6. Website testen.
7. Wartungsmodus wieder deaktivieren.

Wartungsmodus per Drush aktivieren und deaktivieren

Bei grösseren Updates oder kritischen Wartungsarbeiten sollten Besucher nicht auf eine halb aktualisierte Website zugreifen. Dafür nutzen Sie den Wartungsmodus. Mit Drush können Sie diesen Zustand schnell setzen:

Nach Abschluss der Wartung deaktivieren Sie den Wartungsmodus wieder:

Der anschliessende Cache-Rebuild ist wichtig, damit Drupal den geänderten Status zuverlässig berücksichtigt. Prüfen Sie die Website danach in einem Browserfenster, in dem Sie nicht als Administrator angemeldet sind.

Module mit Drush verwalten

Drush kann Module aktivieren oder deinstallieren. Wichtig ist aber: Das Herunterladen und Verwalten von Modul-Code erfolgt bei modernen Drupal-Projekten normalerweise über Composer. Drush ersetzt Composer nicht. Es aktiviert nur Erweiterungen, die im Projekt bereits vorhanden sind.

Ein typischer Ablauf zum Installieren eines neuen Moduls sieht so aus:

Die Kurzform für das Aktivieren eines Moduls ist häufig:

Zum Deinstallieren verwenden Sie:

Deinstallieren Sie Module niemals blind. Prüfen Sie vorher, ob andere Module, Konfigurationen oder Inhalte davon abhängig sind. Besonders bei produktiven Websites sollten solche Änderungen zuerst in einer Testumgebung durchgeführt werden.

Drupal-Status prüfen

Der Befehl status ist ideal, um eine schnelle technische Übersicht zu erhalten:

Je nach Version und Umgebung zeigt Drush Informationen wie Drupal-Version, Site-URI, Datenbankverbindung, PHP-Version, Konfigurationspfad, Dateipfade und Drush-Version an. Diese Angaben sind besonders hilfreich bei Fehlersuche, Supportfällen und Migrationsarbeiten.

Wenn Drush keinen gültigen Status ausgeben kann, prüfen Sie zuerst:

• Befinden Sie sich im richtigen Projektverzeichnis?
• Ist Drush im Projekt unter vendor/bin/drush installiert?
• Ist die Drupal-Installation vollständig eingerichtet?
• Ist die Datei settings.php vorhanden und korrekt?
• Stimmt die PHP-Version in der Kommandozeile?
• Kann die Datenbank erreicht werden?

Cron mit Drush manuell ausführen

Drupal nutzt Cron für wiederkehrende Aufgaben. Dazu gehören unter anderem das Verarbeiten von Warteschlangen, Aktualisieren bestimmter Daten, Bereinigen temporärer Informationen oder Indexieren von Inhalten. Cron kann automatisch eingerichtet werden, lässt sich aber auch manuell über Drush starten:

Dieser Befehl ist nützlich, wenn Sie testen möchten, ob Cron-Aufgaben korrekt funktionieren, oder wenn bestimmte Hintergrundprozesse sofort ausgeführt werden sollen. Bei grösseren Websites sollte Cron zuverlässig automatisiert werden, damit Wartungsaufgaben nicht vergessen gehen.

Konfiguration exportieren und importieren

Eine der wichtigsten Stärken moderner Drupal-Versionen ist das Konfigurationsmanagement. Einstellungen von Inhaltstypen, Feldern, Views, Menüs, Rollen, Anzeigeformaten und vielen weiteren Strukturelementen können exportiert und versioniert werden. Drush ist dafür ein zentrales Werkzeug.

Konfiguration exportieren:

Konfiguration importieren:

In Kurzform werden diese Befehle häufig als drush cex und drush cim verwendet. Sie sind besonders relevant, wenn eine Website in mehreren Umgebungen betrieben wird, zum Beispiel lokal, auf Staging und produktiv.

Ein typischer Workflow:

1. Konfiguration lokal oder auf einer Entwicklungsumgebung ändern.
2. Konfiguration mit Drush exportieren.
3. Änderungen in Git versionieren.
4. Code und Konfiguration auf die Zielumgebung deployen.
5. Konfiguration dort mit Drush importieren.
6. Datenbankupdates und Cache-Rebuild ausführen.

Konfigurationsimporte sollten auf produktiven Websites mit grosser Sorgfalt durchgeführt werden. Ein Import kann bestehende Einstellungen überschreiben. Prüfen Sie deshalb vorher, welche Änderungen importiert werden.

Benutzerzugriff mit Drush wiederherstellen

Drush ist auch hilfreich, wenn der Administratorzugang nicht mehr funktioniert. Mit dem folgenden Befehl können Sie einen einmaligen Login-Link für einen Benutzer erzeugen:

Je nach Bedarf können Sie einen bestimmten Benutzer angeben. Der generierte Link sollte nur über sichere Kanäle verwendet und nicht öffentlich geteilt werden. Er ermöglicht direkten Zugriff und ist deshalb sicherheitskritisch.

Für den produktiven Betrieb empfiehlt sich zusätzlich:

• starke Passwörter verwenden,
• 2-Faktor-Authentifizierung für Administratoren einrichten,
• keine gemeinsam genutzten Admin-Konten verwenden,
• ungenutzte Benutzerkonten deaktivieren,
• Rollen und Berechtigungen regelmässig prüfen.

Drush und Composer: klare Aufgabenverteilung

Drush und Composer werden oft zusammen genutzt, erfüllen aber unterschiedliche Aufgaben. Composer verwaltet PHP-Pakete, Drupal Core, Module, Themes und Bibliotheken. Drush führt Drupal-spezifische Befehle auf einer bestehenden Installation aus.

Diese Trennung ist wichtig für stabile Drupal-Projekte. Verwenden Sie Composer für Abhängigkeiten und Code. Verwenden Sie Drush für Drupal-interne Operationen.

Sicherer Update-Ablauf mit Composer und Drush

Ein professioneller Drupal-Update-Prozess kombiniert Composer, Drush, Backups und Tests. Die genaue Vorgehensweise hängt vom Projekt ab. Ein typischer Ablauf kann so aussehen:

1. Backup erstellen: Sichern Sie Dateien und Datenbank vollständig.
2. Wartungsfenster planen: Grössere Updates sollten nicht während Spitzenzeiten erfolgen.
3. Wartungsmodus aktivieren: Besucher sehen eine Wartungsseite statt möglicher Fehlermeldungen.
4. Code aktualisieren: Drupal Core und Module per Composer aktualisieren.
5. Datenbankupdates ausführen: Mit vendor/bin/drush updatedb.
6. Cache neu aufbauen: Mit vendor/bin/drush cr.
7. Website testen: Backend, Frontend, Formulare, Login, wichtige Inhaltstypen und kritische Funktionen prüfen.
8. Wartungsmodus deaktivieren: Website wieder freigeben.
9. Monitoring durchführen: Logmeldungen und Fehlerberichte prüfen.

Auf produktiven Websites sollte dieser Ablauf zuerst in einer Staging-Umgebung getestet werden. So lassen sich Modulkonflikte, veränderte Abhängigkeiten oder Datenbankprobleme erkennen, bevor Besucher betroffen sind.

Drush in Staging- und Deployment-Workflows

Drush entfaltet seine volle Stärke in professionellen Workflows. Wenn Sie mit Entwicklungs-, Staging- und Produktionsumgebungen arbeiten, können Drush-Befehle wiederkehrende Schritte standardisieren. Dadurch sinkt das Risiko manueller Fehler.

Typische Deployment-Schritte können sein:

Der Parameter -y bestätigt Rückfragen automatisch. Er ist praktisch für automatisierte Deployments, sollte aber nur verwendet werden, wenn der Ablauf getestet und verstanden wurde. Auf produktiven Systemen kann eine automatische Bestätigung sonst unerwünschte Änderungen auslösen.

Häufige Fehler und deren Ursachen

Drush-Fehler wirken auf den ersten Blick manchmal kompliziert. Viele Probleme haben jedoch typische Ursachen. Die folgende Übersicht hilft bei der ersten Diagnose.

Bei Fehlersuche ist vendor/bin/drush status oft der beste erste Befehl. Er zeigt, ob Drush die Website überhaupt korrekt erkennt.

Sicherheitsregeln für Drush

Drush ist mächtig. Genau deshalb sollten Befehle mit Sorgfalt ausgeführt werden. Einige Befehle verändern Datenbank, Konfiguration, Benutzer oder aktivierte Erweiterungen. Fehler können sich sofort auf die Live-Website auswirken.

Beachten Sie deshalb diese Sicherheitsregeln:

• Führen Sie produktive Befehle nur aus, wenn Sie deren Wirkung verstehen.
• Erstellen Sie vor Updates und Datenbankoperationen immer Backups.
• Arbeiten Sie bei grösseren Änderungen zuerst in einer Staging-Umgebung.
• Verwenden Sie keine gemeinsam genutzten SSH-Zugänge.
• Beschränken Sie SSH-Zugriff auf Personen, die ihn wirklich benötigen.
• Speichern Sie keine Passwörter in Shell-History oder unsicheren Skripten.
• Nutzen Sie sichere SSH-Schlüssel und starke Passphrasen.
• Prüfen Sie nach Wartungsarbeiten die Drupal-Logs.

Gerade Befehle mit automatischer Bestätigung wie -y sollten nur in kontrollierten Workflows verwendet werden. Für manuelle Arbeiten ist es oft sicherer, Rückfragen bewusst zu bestätigen.

Drush und Performance

Drush selbst macht Ihre Website nicht automatisch schneller. Es hilft aber, Performance-relevante Wartungsarbeiten effizienter durchzuführen. Dazu gehören Cache-Rebuilds, Cron-Läufe, Updates, Konfigurationsimporte und Deployment-Prozesse. Besonders bei komplexen Drupal-Websites mit vielen Modulen, Views und Inhaltstypen kann eine schnelle CLI-Verwaltung den Administrationsaufwand deutlich reduzieren.

Für sehr umfangreiche Projekte oder Entwicklungsumgebungen mit häufigen Composer- und Drush-Abläufen kann ein leistungsfähigeres Hosting sinnvoll sein. Mehr CPU-Leistung, Arbeitsspeicher und schnellere I/O-Performance wirken sich vor allem bei Composer-Operationen, Cache-Aufbau und Datenbankoperationen positiv aus.

Für anspruchsvolle Drupal-Projekte, Staging-Umgebungen oder individuelle Entwicklungsworkflows kann ein VPS Cloud Server von CURIAWEB sinnvoll sein. Dort stehen Ihnen mehr Ressourcen und mehr technische Flexibilität zur Verfügung als in klassischen Shared-Hosting-Umgebungen.

Kurze Checkliste für den Drush-Einsatz

• SSH-Zugriff ist aktiviert und sicher eingerichtet.
• Die Drupal-Website wird mit Composer verwaltet.
• Drush ist projektspezifisch per Composer installiert.
• Sie führen Drush aus dem richtigen Projektverzeichnis aus.
• vendor/bin/drush status erkennt die Website korrekt.
• Vor Updates existiert ein aktuelles Backup.
• Wartungsmodus wird bei grösseren Arbeiten genutzt.
• Datenbankupdates werden nach Code-Updates ausgeführt.
• Nach Änderungen wird der Cache neu aufgebaut.
• Produktive Befehle werden zuerst in Staging getestet, wenn ein Risiko besteht.

FAQ zu Drush

Fazit: Drush ist Pflichtwissen für professionelle Drupal-Verwaltung

Drush ist eines der wichtigsten Werkzeuge für professionelle Drupal-Administration. Es beschleunigt Wartung, Updates, Diagnose, Entwicklung und Deployment erheblich. Wer Drupal-Projekte technisch betreut, sollte die grundlegenden Drush-Befehle sicher beherrschen und wissen, wann Composer, Drush oder das Backend das richtige Werkzeug ist.

Besonders wertvoll ist Drush bei wiederkehrenden Aufgaben: Cache neu aufbauen, Datenbankupdates ausführen, Cron starten, Konfiguration exportieren oder Module verwalten. In Kombination mit SSH-Zugriff, Composer, Backups und einer Staging-Umgebung entsteht ein sauberer Workflow für zuverlässige Drupal-Websites.