Install a global Drush via Composer

Follow the instructions below, or watch a video by Drupalize.me.

  1. Install Composer globally.
  2. Add composer's bin directory to the system path by placing export PATH="$HOME/.composer/vendor/bin:$PATH" into your ~/.bash_profile (Mac OS users) or into your ~/.bashrc (Linux users).
  3. Install latest stable Drush: composer global require drush/drush.
  4. Verify that Drush works: drush status

Notes

  • Update to latest release (per your specification in ~/.composer/composer.json): composer global update
  • Install a specific version of Drush:

    # Install a specific version of Drush, e.g. Drush 7.1.0
    composer global require drush/drush:7.1.0
    
    # Install 8.x branch as a git clone. Great for contributing back to Drush project.
    composer global require drush/drush:8.x-dev --prefer-source
    
  • Alternate way to install for all users via Composer:

    COMPOSER_HOME=/opt/drush COMPOSER_BIN_DIR=/usr/local/bin COMPOSER_VENDOR_DIR=/opt/drush/7 composer require drush/drush:7
    
  • Documentation for composer's require command.

  • Uninstall with : composer global remove drush/drush

Windows

Drush on Windows is experimental, since Drush's test suite is not running there (help wanted).

  • Acquia Dev Desktop is excellent, and includes Drush. See the terminal icon after setting up a web site.
  • Or consider running Linux/OSX via Virtualbox. Drupal VM and Vlad are popular.* These Windows packages include Drush and its dependencies (including MSys). * 7.0.0 (stable). * 6.6.0. * 6.0.
  • Or install LAMP on your own, and run Drush via Git's shell, in order to insure that all depedencies are available.
  • When creating site aliases for Windows remote machines, pay particular attention to information presented in the example.aliases.drushrc.php file, especially when setting values for 'remote-host' and 'os', as these are very important when running Drush rsync and Drush sql-sync commands.