Installation

System Requirements

Lando is designed to work on a wide range of computers. Here are some basic guidelines to ensure your Lando experience is as smooth as possible.

Operating System

Docker Engine Requirements

Please also verify you meet the requirements needed to run our Docker engine backend. Note that the macOS and Windows Lando installer will install Docker for you if needed.

Hardware Requirements

Not for the faint of heart!

Note that Lando is basically a PaaS running on your computer and as such we don't recommend you use it UNLESS YOU'VE GOT POWER!!!open in new window.

Minimum requirements

You can run Lando using the below but your experience may be less than ideal.

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

Preferred

We've found the below or better to deliver the best experience.

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

Preflight Checks

  1. Verify that your system meets the minimum system and hardware requirements to run Lando.
  2. Verify that you are connected to the internet.
  3. Verify that you have administrative access to your machine.

Optional checks

  1. If you already have Docker installed it needs to be set to factory defaults.
  2. If you are also running VirtualBox on Windows check out this.

MacOS

Do not fear the package size!

Note that our macOS installer includes Docker Desktop and this accounts for its large file size in comparison to our Linux packages.

When going through the installer you can choose to not install Docker Desktop, although we recommend you use the version of Docker Desktop that we ship for compatibility and support reasons!

  1. Download the latest .dmg package from GitHubopen in new window
  2. Mount the DMG by double-clicking it
  3. Double-click on the LandoInstaller.pkg
  4. Go through the setup workflow
  5. Enter your username and password when prompted

Choose the correct DMG for your chip architecture

If you have a new Apple Silicon based Mac then choose the arm64. Use the x64 DMG for the older Intel chip Macs.

Note that Apple Silicon support is still a work in progress and YMMV.

Install via HomeBrewopen in new window (third party)

We do not maintain this!

Please note that the versions of Lando and Docker installed via Homebrew are community-maintained and may not be the latest version as provided by the .dmg package from GitHubopen in new window. This also means that brew may install an unsupported version of Docker for you.

See: https://github.com/Homebrew/homebrew-cask/blob/master/Casks/l/lando.rbopen in new window

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

Linux

  1. Install the Docker Community Editionopen in new window for your Linux version. Visit https://get.docker.comopen in new window for the "quick & easy install" script. (at least version 19.03.1-ce)
  2. Download the latest .deb, .pacman or .rpm package from GitHubopen in new window
  3. Double click on the package and install via your distributions "Software Center" or equivalent.
  4. Make sure you look at the caveats below and follow them appropriately

Install from source for other Linux distros

If your Linux distro does not support our .deb, .pacman or .rpm packages you can install from source

Install via CLI

Make sure you have wget installed.

Debian

wget https://files.lando.dev/installer/lando-x64-stable.deb
sudo dpkg -i lando-x64-stable.deb

Fedora

wget https://files.lando.dev/installer/lando-x64-stable.rpm
sudo dnf install lando-x64-stable.rpm

Arch

wget https://files.lando.dev/installer/lando-x64-stable.pacman
sudo pacman -U lando-x64-stable.pacman

Make sure you look at the caveats below and follow them appropriately as well.

Caveats

docker-ce

We set docker-ce as a hard dependency for our packages. This means if you have docker installed a different way it is likely installing the package will fail. You may be able to get around this if your package utility allows dependency ignorance

dpkg -i --ignore-depends=docker-ce lando-stable.deb

After installing lando this way, you may need to edit the /var/lib/dpkg/status file and remove docker-ce from the lando package dependency list in order for future apt related commands to work. Great care should be taken while editting this file!!!.

We are currently considering whether to support alternate means of installing Docker such as with moby-engineopen in new window

Arch

Lando is also available on the AUR as lando-gitopen in new window, meaning it's built directly from source.

Additional Setup

Because each Linux distribution handles things differently, these considerations may or may not apply to you:

  • If your distro uses a docker group, make sure your user is a member of it:

    sudo usermod -aG docker $USER
    

    You will need to log out for this change to take effect. Sometimes a reboot is necessary. See thisopen in new window for more details.

  • If your distro uses SystemD, make sure that both docker.service and docker.socket daemons are running.

  • If you are using Manjaro or another Arch-based distro, you may need to enable the AUR repositoryopen in new window for dependencies.

Windows

YOU MUST HAVE WSL2 ENABLED

Make sure that the WSL2 feature is enabledopen in new window or the Lando installer will fail.

If you want to use the older Hyper-Vopen in new window compatible version of Lando use version 3.6.5 or below however it is recommended to update to the new WSL based backend.

Do not fear the package size!

Note that our Windows installer includes Docker Desktop and this accounts for its large file size in comparison to our Linux packages.

When going through the installer you can choose to not install Docker Desktop, although we recommend you use the version of Docker Desktop that we ship for compatibility and support reasons!

  1. Make sure you are using at least Windows 10 Home or Professional version 21H2 or higher
  2. Download the latest Windows .exe installer from GitHubopen in new window
  3. Double-click on lando.exe
  4. Go through the setup workflow
  5. Approve various UAC prompts during install

From source

To install from source you need to first make sure you've manually installed the below dependencies:

Once you've completed the above then do the following:

# Clone the Lando source
git clone https://github.com/lando/cli.git lando-cli

# Install its dependencies
cd lando-cli && yarn

# ON WINDOWS:
# Find the current path with command prompt: cd or powershell: pwd
# Add C:\path\from\above\bin to PATH
# See: https://www.computerhope.com/issues/ch000549.htm
# Remember to relaunch your terminal so the PATH changes take effect
lando.js
# Or invoke directly
node "C:\path\from\above\bin\lando.js"

# ON POSIX:
# Set up a symlink
# NOTE: we use lando.dev as a convention but you can name it whatever
# This allows you to run stable lando and source lando side by side
sudo mkdir -p /usr/local/bin
sudo ln -s $(pwd)/bin/lando.js /usr/local/bin/lando.dev

# Run lando from source
lando.dev