Make sure the following executables are available in your system:
docker
lando
sudo
Make sure you're only running this script against a compatible Drupal 9 branch (e.g. 9.0.x
). In doubt, clone the preferred branch like so:
git clone --branch 9.0.x https://git.drupalcode.org/project/drupal.git
Copy the d9.py
file under e.g. /usr/local/bin/d9
to invoke it from anywhere.
Alternatively, simply create the following Bash alias in your .bash_aliases
file to invoke the script from anywhere.
alias d9='path/to/d9.py'
Do not forget to enable those changes immediately, so you can avoid to logout or reboot.
source ~/.bash_aliases
Just type d9 [--install|--wipe]
in a terminal.
usage: d9.py [-h] (--install | --wipe)
Drupal 9 installer
optional arguments:
-h, --help show this help message and exit
--install Spin up a new Lando app and install Drupal
--wipe Reset the Git repo and destroy all Lando containers
Note: sudo
is required for the --wipe
parameter.
The site is accessible at http:https://drupal9.lndo.site - If you're running Apache or any other app binding to port 80, then Lando will try to bind to another port (e.g. 8000
or 8080
). Your options are thus to either free up port 80 (see below to find out how), use the automatically-assigned port or try one of the other Lando URLs such as https://drupal9.lndo.site (to prevent your browser from throwing a SSL warning, follow this procedure)
On Linux, try and use the lsof
command to check if port 80 is already in use. Here's an example with a local Apache server (apache2
service) that will conflict with Lando's attempt to bind on port 80 by default.
sudo lsof -n -i :80 | grep LISTEN
apache2 20953 root 4u IPv6 28849622 0t0 TCP *:http (LISTEN)
apache2 20958 www-data 4u IPv6 28849622 0t0 TCP *:http (LISTEN)
apache2 20959 www-data 4u IPv6 28849622 0t0 TCP *:http (LISTEN)
apache2 20960 www-data 4u IPv6 28849622 0t0 TCP *:http (LISTEN)
apache2 20962 www-data 4u IPv6 28849622 0t0 TCP *:http (LISTEN)
apache2 20965 www-data 4u IPv6 28849622 0t0 TCP *:http (LISTEN)
If you're in this situation, you might want to stop the Apache service for this session (it will start automatically again next time you reboot) and restart your Lando app like so on Linux:
$ sudo service apache2 stop
$ lando restart
When Lando binds successfully to port 80 (via Docker), you should see something like this instead:
sudo lsof -n -i :80 | grep LISTEN
docker-pr 25050 root 4u IPv6 28900587 0t0 TCP *:http (LISTEN)
Use admin
for username and admin
for password.