How to install Homebrew, Composer, and Drush on Mac OSX Sierra, High Sierra, Mojave, Catalina

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:

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!