Installing Varbase with Lando

Lando is a great local development environment for Drupal and other applications that vastly simplifies local development and DevOps so you can focus on the application, rather than the environment.

Learn more about Lando on the official website: lando.dev

Lando is a development tool!

Note that while you can run Lando in production, it is highly discouraged, not recommended, and 100% not supported! DON'T DO IT!

Follow the steps below to setup Varbase with Lando.

  1. Install Lando on your machine. Whether you use Linux, Mac, Windows, there's a package for you. Follow this guide to install Lando on your machine.

  2. Create a new Varbase project using Composer, this will include a template file for .lando.yml, for information on how to integrate Lando on an existing project scroll to the bottom of this page.

    composer create-project vardot/varbase-project:~10 MY_VARBASE_PROJECT --no-dev --no-interaction
  3. Edit the .lando.yml file and change the name value to your project's name.

    cd MY_VARBASE_PROJECT
    vim .lando.yml
  4. Edit the settings.php file and add the following code to setup the database connection and the config sync directory.

    $databases['default']['default'] = [
      'database' => 'drupal10',
      'username' => 'drupal10',
      'password' => 'drupal10',
      'prefix' => '',
      'host' => 'database',
      'port' => '3306',
      'isolation_level' => 'READ COMMITTED',
      'driver' => 'mysql',
      'namespace' => 'Drupal\\mysql\\Driver\\Database\\mysql',
      'autoload' => 'core/modules/mysql/src/Driver/Database/mysql/'
    ];
    
    $settings['config_sync_directory'] = '../config/sync';
    
  5. Start the Lando project and enjoy.

    lando start

For more information on the Lando file configuration, read more on https://docs.lando.dev/drupal/getting-started.html

You can type lando info to know the MySQL database hostname, username, password, and all environment config you'll need.

Adding Lando to an existing Varbase project

  1. Download .lando.yml file and .lando folder from the Varbase project repository https://github.com/Vardot/varbase-project .

  2. Proceed with steps 3, 4, 4, and 5 mentioned above.

Last updated