347295609f26fa38683e70b8824d4f9125978adb
[yaffs-website] / vendor / drush / drush / docs / install-alternative.md
1 Install a global Drush via Composer
2 ------------------
3 Follow the instructions below, or [watch a video by Drupalize.me](https://youtu.be/eAtDaD8xz0Q).
4
5 1. [Install Composer globally](https://getcomposer.org/doc/00-intro.md#globally).
6 1. 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).         
7 1. Install latest stable Drush: `composer global require drush/drush`.
8 1. Verify that Drush works: `drush status`
9
10 #### Notes
11 * Update to latest release (per your specification in ~/.composer/composer.json): `composer global update`
12 * Install a specific version of Drush:
13
14         # Install a specific version of Drush, e.g. Drush 7.1.0
15         composer global require drush/drush:7.1.0
16
17         # Install 8.x branch as a git clone. Great for contributing back to Drush project.
18         composer global require drush/drush:8.x-dev --prefer-source
19
20 * Alternate way to install for all users via Composer:
21
22         COMPOSER_HOME=/opt/drush COMPOSER_BIN_DIR=/usr/local/bin COMPOSER_VENDOR_DIR=/opt/drush/7 composer require drush/drush:7
23
24 * [Documentation for composer's require command.](http://getcomposer.org/doc/03-cli.md#require)
25 * Uninstall with : `composer global remove drush/drush`
26
27 Windows
28 ------------
29 Drush on Windows is experimental, since Drush's test suite is not running there ([help wanted](https://github.com/drush-ops/drush/issues/1612)).
30
31 * [Acquia Dev Desktop](https://www.acquia.com/downloads) is excellent, and includes Drush. See the terminal icon after setting up a web site.
32 * Or consider running Linux/OSX via Virtualbox. [Drupal VM](http://www.drupalvm.com/) and [Vlad](https://github.com/hashbangcode/vlad) are popular.* These Windows packages include Drush and its dependencies (including MSys).     * [7.0.0 (stable)](https://github.com/drush-ops/drush/releases/download/7.0.0/windows-7.0.0.zip).    * [6.6.0](https://github.com/drush-ops/drush/releases/download/6.6.0/windows-6.6.0.zip).    * [6.0](https://github.com/drush-ops/drush/releases/download/6.0.0/Drush-6.0-2013-08-28-Installer-v1.0.21.msi).
33 * Or install LAMP on your own, and run Drush via [Git's shell](https://git-for-windows.github.io/), in order to insure that [all depedencies](https://github.com/acquia/DevDesktopCommon/tree/8.x/bintools-win/msys/bin) are available.   
34 * 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.