Bobcares

How to Fix the “Drush Command Not Found” Error in Drupal

by | Apr 1, 2025

Learn how to fix the “Drush Command Not Found” error in Drupal. Our Drupal Support team is here to help you with your questions and concerns.

How to Fix the “Drush Command Not Found” Error in Drupal

Drush is a command-line tool for managing Drupal websites, making tasks like updating modules and clearing caches much more efficient. However, after installing Drush, we may run into the following error:

How to Fix the "Drush Command Not Found" Error in Drupal
-bash: drush: command not found

This issue prevents us from using Drush commands and can stem from several underlying causes, such as incorrect installation, missing paths, or permission problems.

Common Causes of “Drush Command Not Found”

Several factors can lead to this error:

  • The installation may not have been completed successfully.
  • The Drush executable is not included in the system’s `$PATH`.
  • Also, Drush might be incompatible with the currently active PHP version.
  • Sometimes, insufficient permissions prevent access to Drush.
  • Conflicts between global and local installations.

How to Fix the Issue

Once Drush is installed, we must ensure the correct directory is included in the `$PATH`. Follow these steps to resolve the error:

  1. First, check if Drush is installed and where it’s located by running:
    which drush

    If this command does not return a valid path, Drush might not be installed, or the system will not recognize it.

  2. If Drush is installed but not recognized, we must update your system’s `$PATH` variable. Run the following command:
    export PATH=”$HOME/.composer/vendor/bin:$PATH”

    Also, if we use a newer version of Composer, Drush may be installed in `~/.config/composer/vendor/bin` instead. In that case, update your `$PATH` like this:

    export PATH=”$HOME/.config/composer/vendor/bin:$PATH”

    To make this change permanent, add the line to the `~/.bash_profile` or `~/.bashrc` file and then reload it:

    source ~/.bash_profile # or source ~/.bashrc
  3. If the above steps don’t work, we can try reinstalling Drush using one of these methods:
    • Using Composer

      If we are working on a Drupal 8 or later project that requires Drush as a dependency, we can install Drush within your project directory:

      sudo COMPOSER_HOME=/var/lib/composer COMPOSER_BIN_DIR=/usr/local/bin COMPOSER_VENDOR_DIR=/var/lib/composer/vendor composer require drush/drush:~8
    • Installing Drush via Phar

      If we don’t need Composer, install Drush globally using Drush’s `.phar` file:

      sudo install <(curl -LsS http://files.drush.org/drush.phar) /usr/local/bin/drush
    • Installing Drush on macOS with Homebrew

      For macOS users, we can install Drush via Homebrew as seen here:

      brew install drush
  4. If we manage multiple Drupal projects using different Drush versions, installing Drush Launcher can help:
    composer global require drush/drush-launcher

    So, this lets us call Drush commands globally without worrying about version conflicts.

[Need assistance with a different issue? Our team is available 24/7.]

Conclusion

The “Drush command not found” error is usually caused by missing paths, PHP conflicts, or installation issues. By verifying our installation, updating system paths, and ensuring compatibility, we can restore Drush functionality and efficiently manage our Drupal site.

In brief, our Support Experts demonstrated how to fix the “open \\.\pipe\docker_engine: Access is denied” error in Docker for Windows.

0 Comments

Submit a Comment

Your email address will not be published. Required fields are marked *

Speed issues driving customers away?
We’ve got your back!