Skip to content

Install

Tip

Drush only supports one install method. It requires that your Drupal site be built with Composer and Drush be listed as a dependency.

See the Drush 8 or Drush 9 docs for installing prior versions of Drush.

  1. It is required that Drupal sites be built using Composer, with Drush listed as a dependency. Popular starter templates for that include drupal-project (Drush is included) and recommended-project (Drush must be added). If your Composer project doesn't yet depend on Drush, run composer require drush/drush to add it. After this step, you may call Drush via vendor/bin/drush.
  2. Optional. To be able to call drush from anywhere, install the Drush Launcher. That is a small program which listens on your $PATH and hands control to a site-local Drush that is in the /vendor directory of your Composer project.

Note

Drupal Compatibility

Drush Version PHP Version End Of Life Drupal versions
7 8 9 10
Drush 12 8.1+ TBD
Drush 11 7.4+ TBD
Drush 10 7.1+ (not 8) Jan 2022
Drush 9 5.6+ May 2020
Drush 8 5.4.5+ Nov 2023 ⚠️
Drush 7 5.3.0+ Jul 2017
Drush 6 5.3.0+ Dec 2015
Drush 5 5.2.0+ May 2015
Legend
Supported and recommended
⚠️ Supported but not recommended
Compatible but no longer supported

Last update: May 31, 2023