Drush - Drupal Shell utility

Last updated January 20, 2012. Created by dman on May 31, 2009.
Edited by Aham, pferlito, cookiesunshinex, clemens.tolboom. Log in to edit this page.

Drush or drupal shell is a command-line utility to help the site building and maintenance workflows.

Available Drush Commands:

For a list of available commands either visit http://drush.ws or type drush help.

For a printable version use drush help --html

Extensions

Other modules provide new drush commands! These become available automatically and are listed when you run drush help.

Tips

Drush autodetects the appropriate site from directory context, and read its configs from there, so if your command shell is in {drupaldir}/sites/all or anywhere under {drupaldir} then drush commands will apply to your default install. If you move your shell session into {drupaldir}/sites/mysite, then drush commands will be run in the context of the mysite multisite instance. You can always run drush status to check the currently active context.

When updating with Drush, it is not necessary to put the site in maintenance mode. See Moshe's statement

Example Commands

drush dl cck zen

Download current recommended versions of CCK module and Zen theme.

drush enable content

Enable the content (cck) module.

drush --uri=http://example.com status

Show status command for the example.com multi-site.

drush pm-releases backup_migrate

Get info on all available releases for backup_migrate.module, e.g.

Project         Release      Date       
backup_migrate  6.x-2.x-dev  2009-Apr-07
backup_migrate  6.x-1.2      2009-Jan-18
backup_migrate  6.x-1.0      2008-Aug-14
backup_migrate  6.x-1.x-dev  2009-Feb-19

drush -v  dl backup_migrate-6.x-1 --package-handler=git_drupalorg

Checkout via git, the current stable version of the backup_migrate module on the DRUPAL-6--1 branch into your sites/{active.site}/modules/ directory. In this case the result is identical with just drush dl backup_migrate --package-handler=git_drupalorg as the requested version is the recommended version.

drush -v  dl backup_migrate-6.x-2.x-dev --package-handler=git_drupalorg

Checkout via git, the unstable dev version of the backup_migrate module on the DRUPAL-6--2 branch into your sites/{active.site}/modules/ directory.

drush -v  dl backup_migrate-6.x-2.x-dev

Without specifying a --package-handler, (the default) the project bundle is retrieved via wget, and unpacked locally without the git information. This may overwrite any local changes.

drush pm-update devel

Update the devel module to the latest recommended release and apply any database updates

drush pm-update drupal

To update only Drupal core (in case of a security update)

See also: Offsite blog tutorial (with pictures) on Installing and running drush on OSX by morten