If you’re not able to use Cloud IDE, Acquia provides limited integration with Lando, which is a Docker-based local environment.
You will still be running everything inside of a container, but instead of using Vagrant and Virtualbox you will use Docker. All commands will be run on your local machine with the Lando wrapper.
If you have been using the DrupalVM and want to switch an existing project from the DrupalVM to Lando see the notes below.
Switching from DrupalVM to Lando with BLT v.11 on an existing project.
System Requirements (at the time of writing this article):
- BLT: ^11.x If you want to use BLT 12.x see this article. https://support.acquia.com/hc/en-us/articles/360045796154-Upgrading-from-BLT-11-to-BLT-12
- Lando: If you do not have Lando installed view these docs
- Docker: ^Docker version 20.10.2
- Operating System: OS 10.14.6 or higher (adjust accordingly if you are on Windows)
Step 0: Back up anything you need from your VM
Since we are going to be destroying your VM instance save any custom configuration you might want to save for later.
Step One: Remove DrupalVM configuration
1a) Destroy your vagrant instance
Open a terminal window and navigate to your project and run the following commands
1b) Check your local.blt.yml file for any VM configuration, if so remove it.
1c) Remove DrupalVM composer dependency from composer.json and update your lock file
composer remove geerlingguy/drupal-vm
1d) Remove the /box directory
1e) Remove the Vagrantfile file
Step Two: Add Lando configuration
2a) Add the blt-lando plugin
composer require mikemadison13/blt-lando
Run BLT Lando recipe to create your Lando configuration for you.
Review your lando.yml file.
2b) Change your hostname in your blt.yml file
blt.yml file and change your hostname to
# This will be used as the local uri for all developers.
Step Three: Update your database information
3a) Review or update local.blt.yml to add the following. (Change to drupal9 if you are using Drupal 9) .
3b) Regenerate your local BLT settings
lando blt blt:init:settings
Step Four: BLT setup with Lando
lando blt setup
Then drush uli into your website
lando drush uli
Other Troubleshooting techniques and commands to know
See Lando’s docs about troubleshooting.
Rebuild your VM instance
Shut down your lando instance
Start your lando instance
Delete the vendor directory and core directory before running
Print BLT commands in your terminal
Diagnose issues with BLT doctor
lando blt doctor