Note

Drush 9 (coming soon!) only supports one install method. It requires that your Drupal 8 site be built with Composer and Drush be listed as a dependency.

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

Install a site-local Drush

  1. It is recommended that Drupal 8 sites be built using Composer, with Drush listed as a dependency. That project already includes Drush in its composer.json. If your Composer project doesn't yet depend on Drush, run composer require drush/drush to add it.
  2. To run Drush, navigate to your Drupal root and call ../vendor/bin/drush.
  3. If you want the convenience of calling drush instead of ../vendor/bin/drush, copy the examples/drush.wrapper file to your Drupal root and modify to taste.
  4. If you want the old convenience of being able to call drush from anywhere, see drush-shim.
  5. See Usage for details on using Drush.
  6. MAMP users, and anyone wishing to use a non-default PHP, needs to edit ~/.bashrc so that the right PHP is in your $PATH.

Drupal Compatibility

Drush Version Drush Branch PHP Compatible Drupal versions Code Status
Drush 9 master 5.6+ D8
Drush 8 8.x 5.4.5+ D6, D7, D8
Drush 7 7.x 5.3.0+ D6, D7
Drush 6 6.x 5.3.0+ D6, D7 Unsupported
Drush 5 5.x 5.2.0+ D6, D7 Unsupported