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 to the project root, and call Drush via vendor/bin/drush. To simplify things, add ./vendor/bin to your $PATH, allowing you to call Drush via drush from the project root. If you have only one Drupal codebase on your system, you may put /path/to/vendor/bin in your $PATH; now you can call Drush from everywhere, without having to change to project root.
  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 11
Drush 13 8.3+ TBD
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: April 24, 2024