Skip to content



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. Composer. It is required that Drupal sites be built using Composer, with Drush listed as a dependency. See recommended-project (Drush must be added). If your Composer project doesn't yet depend on Drush, run composer require drush/drush to add it.
  2. Execution. Change your working directory to your project root, and call Drush via vendor/bin/drush. To make this easier, append ./vendor/bin to the end of your $PATH; this allows you to call Drush via drush once your working directory is set. If you only have only one Drupal codebase on your system, you may put /path/to/vendor/bin/drush in your $PATH; if you do this, then it is not necessary to set your working directory before calling Drush.
  3. Completion. Optional. Append to .bashrc or equivalent for ZSH or Fish shell. Run drush completion --help for more details.
  4. Multiple Codebases. Optional. If using the bash shell, consider installing the fd project, a small set of scripts that make it easier to switch between different project directories quickly, with type completion.


Drupal Compatibility

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

Last update: June 6, 2023