Learn how to configure Drupal with Lando

What is Lando?

“Lando is a free, open-source, cross-platform, local development environment and DevOps tool built on Docker container technology. It is mainly designed to work with most major languages, frameworks, and services. Lando provides an easy way for developers of all skill levels to specify simple or complex project requirements and then quickly get to work on them.”

Some of the benefits of Lando

  • Mimicking your production environment locally
  • Offering speedy development with the prebuilt configuration of the composer, drush
  • Add tooling to extend it from services like phpmyadmin, PHP, mailhog, apache, etc
  • Recommends customizable out-of-the-box settings.
  • Using a single local development environment for all your projects

System Requirements

Following are some basic guidelines for your smooth Lando experience:

Operating System

  • macOS 11 or later
  • Windows 10 Home or Pro version 21H2 or higher with the WSL 2 feature enabled
  • Linux with kernel version 4.x or higher

Docker Engine Requirements

A Docker engine is required to run Lando. Based on operating system requirement varies as follow:

Hardware Requirements

Minimum requirements

  • 2-core x86-compat processor
  • 4GB+ RAM
  • 25GB+ of available disk space


  • 8-core processor
  • 16GB+ RAM
  • 100GB+ of available disk space



Install DMG via direct download (recommended)

  • Download the latest .dmg package from GitHub
  • Mount the DMG by double-clicking it
  • Double-click on the LandoInstaller.pkg
  • Go through the setup workflow
  • Enter your username and password when prompted

Install via HomeBrew (third party)

  • Ensure homebrew is installed and up-to-date.
  • Add the lando cask: brew install –cask lando



  • Make sure you are using at least Windows 10 Home or Professional version 21H2 or higher
  • Download the latest Windows .exe installer from GitHub
  • Double-click on lando.exe
  • Go through the setup workflow
  • Approve various UAC prompts during the installation

Setup Drupal 9 with Lando

Download the Drupal codebase

It is recommended to download the Drupal core codebase using Composer because current Drupal uses composer-dependent modules and libraries. To create the project, we’ll use the official composer template for Drupal, it can be found at https://github.com/drupal/recommended-project. To create your project, you should run this command:

composer create-project drupal/recommended-project:^9 lando-demo

Above command will download Drupal core and dependencies into a lando-demo folder.

Initialise Drupal codebase with Lando

Now, let’s start playing with Lando and see how it’s easy to configure. Follow the given steps:

  1. Switch to project directory lando-demo
  2. Run lando init command and you will see below options
  3. Select current working directory as codebase directorypress Enter and you will see below options
  4. Scroll down with the Down arrow key from the keyboard, select drupal9 as the recipe, and press Enter. You will see the below output.
  5. Write web in the web root, press Enter, and you will see the next step.
  6. Enter your app name (e.g. Lando Demo) and press Enter, and you will see the below screen.

After finishing the above steps, .lando.yml file will be created (as a hidden file) in the project directory with some basic details like app name, recipe, webroot etc. The .lando.yml file will always be there in the project root folder. This file may also contain services, tooling, database etc., information based on your project requirements.

Drupal Installation

After initializing Drupal with Lando, we will now proceed to get local development urls. Now, let’s run lando start command to start Lando with docker containers, appserver, database server etc. Once you hit this command, you will see the below output.

To proceed further with Drupal installation, we need database name, username, password, host, etc details. To get these details, run lando info command, and you will get all details.

Get database details from the above screen from service: database section and set it into settings.local.php or settings.php. Proceed with further steps as you follow on normal Drupal installation.

Please click here to get familiar with some useful Lando commands.


Lando is a very powerful tool for managing local services, and it is effortless to install and configure. If you have basic knowledge of Docker, then you can easily customize and configure your Lando setup easily. That’s it! You are now ready to use Drupal with Lando.


Leave a Reply

Your email address will not be published. Required fields are marked *