Project

General

Profile

Installing Drush for working with Drupal 6-8 and Backdrop » History » Version 54

Jack Aponte, 01/23/2020 07:38 PM
restored /usr/local/bin/drush as preferred symlink location as per https://unix.stackexchange.com/questions/8656/usr-bin-vs-usr-local-bin-on-linux

1 14 Jack Aponte
{{lastupdated_at}} by {{lastupdated_by}}
2
3 34 Jack Aponte
{{>toc}}
4
5 1 Jack Aponte
h1. Installing Drush for working with Drupal 6-8 and Backdrop
6
7 40 Jack Aponte
An important note: we no longer need to install any version of Drush except Drush 8, since that now supports "Drupal 6, 7, <8.3 _and_ Backdrop.":http://docs.drush.org/en/master/install/#drupal-compatibility
8 9 Jack Aponte
9 40 Jack Aponte
h2. Installing and updating Drush 8 for all users
10 1 Jack Aponte
11 40 Jack Aponte
I've followed the "Install a global Drush via Composer" instructions under in the "Drush 8 alternative installation documentation.":http://docs.drush.org/en/8.x/install-alternative/
12 28 Jack Aponte
13 41 Jack Aponte
Since running @composer install@ as root is a "security risk":https://getcomposer.org/doc/faqs/how-to-install-untrusted-packages-safely.md, you can use commands like these to install Drush in your home directory first, then move it to a globally-accessible location using @sudo@:
14 8 Jack Aponte
15 1 Jack Aponte
<pre>
16 44 Jack Aponte
cd ~
17 51 Jack Aponte
COMPOSER_HOME=$HOME/drush COMPOSER_VENDOR_DIR=$HOME/drush/8 composer require drush/drush:8.3.2
18 1 Jack Aponte
cd ~/drush/8/drush/drush
19 41 Jack Aponte
composer install
20 47 Jack Aponte
cd ~
21 44 Jack Aponte
sudo mv ~/drush /opt/
22 47 Jack Aponte
sudo chown -R root: /opt/drush
23 54 Jack Aponte
sudo ln -s /opt/drush/8/drush/drush/drush /usr/local/bin/drush
24 1 Jack Aponte
</pre>
25 30 Jack Aponte
26 49 Jack Aponte
If you _must_ run @composer install@ and the other commands above as root, e.g. if that's the only user we have access to on the server, you can do so by changing the @COMPOSER_HOME@ path to @/opt/drush@ and @COMPOSER_VENDOR_DIR@ to @/opt/drush/8@ and adjusting the other commands above accordingly.
27 43 Jack Aponte
28 52 Jack Aponte
Replace "8.3.2" (last updated in this documentation on 01/22/2020) with the tag of the most recent stable 8.3.x release (see https://github.com/drush-ops/drush/releases)
29 1 Jack Aponte
30 40 Jack Aponte
Use the same commands with a new version number to update Drush as needed.
31 1 Jack Aponte
32 50 Jack Aponte
h2. Install and update Drush Backdrop commands
33
34
In order for Drush to work with Backdrop, you must install the "Drush Backdrop commands":https://github.com/backdrop-contrib/drush within the Drush 8 installation itself.
35
36
Assuming that Drush 8 is installed in @/opt/drush/8/drush/drush@, as specified above:
37
38
<pre>
39
sudo git clone https://github.com/backdrop-contrib/drush.git /opt/drush/8/drush/drush/commands/backdrop
40
</pre>
41
42
To update Drush Backdrop commands installed like this:
43
44
<pre>
45
cd /opt/drush/8/drush/drush/commands/backdrop
46
sudo git pull origin
47
</pre>
48
49 1 Jack Aponte
h2. Install Drush on May First/People Link (MFPL) and other shared hosting environments
50
51
Primarily drawn from "this MFPL ticket;":https://support.mayfirst.org/ticket/11691#comment:3 thanks Ivan!
52 17 Jack Aponte
53 18 Jack Aponte
First, install Composer following "these instructions":https://getcomposer.org/download/.
54 17 Jack Aponte
55
Then to install Drush:
56
57
<pre>
58
echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.bashrc
59
source ~/.bashrc
60
cd ~/<organization.org>/bin
61 40 Jack Aponte
php composer.phar global require drush/drush:8.2.3
62 17 Jack Aponte
which drush
63 1 Jack Aponte
</pre>
64 8 Jack Aponte
65
Note that sometimes @cgi-bin@ is present on MF/PL sites instead of @bin@.
66 1 Jack Aponte
67 8 Jack Aponte
If using Drush aliases, you may need to specify the new Drush installation in the shared @aliases.drushrc.php@ file or a local aliases file. Here's an example:
68 1 Jack Aponte
69 40 Jack Aponte
<pre>
70 1 Jack Aponte
$aliases['organization'] = array(
71 10 Jack Aponte
  'remote-host' => 'organization.org',
72 42 Jack Aponte
  'remote-user' => 'organization',
73 10 Jack Aponte
  'root' => '/home/members/organization/sites/organization.org/web',
74
  'uri' => 'organization.org',
75 45 Jack Aponte
  'path-aliases' => array(
76
    '%drush-script' => '/home/members/organization/sites/organization.org/users/organization/.composer/vendor/bin/drush',
77
    '%dump-dir' => '~/drush-backups',
78
    '%files' => '/home/members/organization/sites/organization.org/web/sites/default/files',),
79
);
80
</pre>
Go to top