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.
- 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/drushto add it. - Execution. Change to the project root, and call Drupal's
vendor/bin/dr. To simplify things, add./vendor/binto your$PATH, allowing you to calldrfrom the project root. If you have only one Drupal codebase on your system, you may put/path/to/vendor/binin your$PATH; now you can calldrfrom everywhere, without having to change to project root. - Completion. Optional. Append to .bashrc or equivalent for ZSH or Fish shell. Run
dr completion --helpfor more details.
Note
- See Usage for details on using Drush.
- To use a non-default PHP, edit ~/.bashrc so that the desired PHP is in front of your $PATH. If that is not desirable, you can change your PATH for just one request:
PATH=/path/to/php:$PATH dr status ... - To use custom PHP configuration such as memory_limit, create a custom php.ini for Drush requests as per https://github.com/drush-ops/drush/issues/3294#issuecomment-370201342 and https://github.com/drush-ops/drush/issues/3294#issuecomment-618962852.
- Porting commands from Drush 13? See Upgrading from Drush 13.
Drupal Compatibility¶
| Drush Version | PHP Version | End Of Life | Drupal versions | |||||
|---|---|---|---|---|---|---|---|---|
| 7 | 8 | 9 | 10 | 11 | 12 | |||
| Drush 15 | 8.3+ | TBD | ✅11.5+ | ✅ | ||||
| Drush 14 | 8.4+ | Abandoned - never released | ✅11.4+ | ✅ | ||||
| Drush 13 | 8.3+ | TBD | ✅ 10.2+ | ✅ | ||||
| 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 | ✓ | |||||
| Legend | |
|---|---|
| ✅ | Supported and recommended |
| ✓ | Compatible but no longer supported |