Installing Drush on MacOSX with Composer
In order to install Drush, you should first install Composer. Composer is often required for Drupal 8 and once Composer is installed, installing Drush is easy.
1. Open the Terminal app on your Mac.
2. Install Homebrew via the instructions here: https://brew.sh/
3. Install Composer globally on your Mac with this command:
brew install composer
4. If your computer doesn’t have a “/usr/local/bin” directory, create that first with this command:
sudo mkdir -p /usr/local/bin
…that creates the directory; you should be prompted to enter your computer’s password.
Now, when you type composer --version
and press Enter, we’ll see that you have Composer installed!
5. Install Drush via Composer:
Note!: Please do not install Drush using composer global require
. See Pantheon’s article, Fixing the Composer Global command.
Instead, first install the Composer global require
command:
composer global require consolidation/cgr
6. Add the vendor/bin
from the Composer home directory to your $PATH.
(Thereafter, you may substitute cgr
for any command line tool whose installation instructions recommends the use of Composer global require. Example: cgr drush/drush
)
If you get a popup to install the Xcode Developer tools, go ahead and install Xcode.
7. Update the system $PATH:
vim ~/.bash_profile
to edit the file press the i
key to enter Insert mode
…next, copy and paste this into that file:
export PATH="$HOME/.composer/vendor/bin:$PATH"
PATH="$(composer config -g home)/vendor/bin:$PATH"
Press the Escape (esc) key to switch back to command mode.
Type :wq
and press Enter to save and quit the file.
8. Quit the Terminal app (or, run the “source” command to load the .bash_profile file without having to restart the Terminal.)
To run the source command:
source ~/.bash_profile
9. Now you will actually install Drush:
Install latest stable Drush:
cgr drush/drush
Now if you type drush
and press Enter, you’ll see that Drush is installed, and working on your machine!