PHPackages drush/drush-launcher - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [CLI & Console](/categories/cli) 4. / 5. drush/drush-launcher AbandonedArchivedLibrary[CLI & Console](/categories/cli) drush/drush-launcher ==================== Provides a drush executable for your global PATH 0.10.2(3y ago)23722.9k↓50%49[22 issues](https://github.com/drush-ops/drush-launcher/issues)GPL-2.0-or-laterPHP Since Oct 7Pushed 2y ago13 watchersCompare [ Source](https://github.com/drush-ops/drush-launcher)[ Packagist](https://packagist.org/packages/drush/drush-launcher)[ RSS](/packages/drush-drush-launcher/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (4)Versions (37)Used By (0) Alternatives now that this project is archived. ----------------------------------------------- [](#alternatives-now-that-this-project-is-archived) Add `./vendor/bin` to the front of your `$PATH`. This relative path works for any Drupal codebase on your system if you run commands from the project root. And it is harmless otherwise. Other options include [direnv](https://direnv.net/), [fd](https://github.com/g1a/fd), or the scripts [in this issue](https://github.com/drush-ops/drush-launcher/issues/105). Description ----------- [](#description) In order to avoid dependency issues, it is best to require Drush on a per-project basis via Composer (`composer require drush/drush`). This makes Drush available to your project by placing it at `vendor/bin/drush`. However, it is inconvenient to type `vendor/bin/drush` in order to execute Drush commands. By installing the drush launcher globally on your local machine, you can simply type `drush` on the command line, and the launcher will find and execute the project specific version of drush located in your project's `vendor` directory. Installation - Phar ------------------- [](#installation---phar) 1. Download latest stable release via CLI (code below) or browse to . OSX: ``` curl -OL https://github.com/drush-ops/drush-launcher/releases/latest/download/drush.phar ``` Linux: ``` wget -O drush.phar https://github.com/drush-ops/drush-launcher/releases/latest/download/drush.phar ``` 2. Make downloaded file executable: `chmod +x drush.phar` 3. Move drush.phar to a location listed in your `$PATH`, rename to `drush`: ``` sudo mv drush.phar /usr/local/bin/drush ``` 4. Windows users: create a drush.bat file in the same folder as drush.phar with the following lines. This gets around the problem where Windows does not know that the `drush` file is associated with `php`: ``` @echo off php "%~dp0\drush" %* ``` Update ------ [](#update) The Drush Launcher Phar is able to self update to the latest release. ``` drush self-update ``` Fallback -------- [](#fallback) When a site-local Drush is not found, this launcher usually throws a helpful error. You may avoid the error and instead hand off execution to a global Drush (any version) by exporting an environment variable. `export DRUSH_LAUNCHER_FALLBACK=/path/to/drush` Xdebug compatibility -------------------- [](#xdebug-compatibility) Drush Launcher, like Composer automatically disables Xdebug by default. This improves performance substantially. You may override this feature by setting an environment variable. `DRUSH_ALLOW_XDEBUG=1 drush [command]` License ------- [](#license) GPL-2.0+ ### Health Score 41 — FairBetter than 89% of packages Maintenance18 Infrequent updates — may be unmaintained Popularity43 Moderate usage in the ecosystem Community25 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 60.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~66 days Recently: every ~169 days Total 36 Last Release 1199d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/7740?v=4)[Moshe Weitzman](/maintainers/weitzman)[@weitzman](https://github.com/weitzman) --- Top Contributors [![webflo](https://avatars.githubusercontent.com/u/123946?v=4)](https://github.com/webflo "webflo (56 commits)")[![weitzman](https://avatars.githubusercontent.com/u/7740?v=4)](https://github.com/weitzman "weitzman (28 commits)")[![grasmash](https://avatars.githubusercontent.com/u/539205?v=4)](https://github.com/grasmash "grasmash (2 commits)")[![juampynr](https://avatars.githubusercontent.com/u/108130?v=4)](https://github.com/juampynr "juampynr (1 commits)")[![RobinDeHerdt](https://avatars.githubusercontent.com/u/12544981?v=4)](https://github.com/RobinDeHerdt "RobinDeHerdt (1 commits)")[![TechnologyClassroom](https://avatars.githubusercontent.com/u/14501791?v=4)](https://github.com/TechnologyClassroom "TechnologyClassroom (1 commits)")[![danepowell](https://avatars.githubusercontent.com/u/1984514?v=4)](https://github.com/danepowell "danepowell (1 commits)")[![YahyaAhmad](https://avatars.githubusercontent.com/u/36857365?v=4)](https://github.com/YahyaAhmad "YahyaAhmad (1 commits)")[![gapple](https://avatars.githubusercontent.com/u/458809?v=4)](https://github.com/gapple "gapple (1 commits)")[![hussainweb](https://avatars.githubusercontent.com/u/1040271?v=4)](https://github.com/hussainweb "hussainweb (1 commits)") ### Embed Badge ![Health badge](/badges/drush-drush-launcher/health.svg) ``` [![Health](https://phpackages.com/badges/drush-drush-launcher/health.svg)](https://phpackages.com/packages/drush-drush-launcher) ``` ### Alternatives [humbug/box Fast, zero config application bundler with PHARs. 1.3k801.5k69](/packages/humbug-box)[mglaman/drupal-check CLI tool for running checks on a Drupal code base 3426.6M42](/packages/mglaman-drupal-check)[drupal/console-core Drupal Console Core 13514.7M12](/packages/drupal-console-core)[acmephp/acmephp Let's Encrypt client written in PHP 649155.1k](/packages/acmephp-acmephp)[jigarius/drall Drall is a command-line utility to run drush on multi-site Drupal installations. 35105.9k](/packages/jigarius-drall)[puli/cli A Command Line Interface (CLI) for managing Puli projects. 5147.2k14](/packages/puli-cli) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)