Lando 3

Appearance

Jobs
Lando System Inc
Lando Developer
Lando System Inc - DC, Remote
SPONSORS

WSL ​

The WSL quickstart is to launch a WSL instance, copy the below into a terminal and execute it.

bash
/bin/bash -c "$(curl -fsSL https://get.lando.dev/setup-lando.sh)"

WSL vs Linux

Note that lando setup behaves differently on wsl vs linux. On wsl Lando will install Docker Desktop on the Windows host. On linux Lando will install Docker Engine on Linux.

Also note that if your wsl environment has WSL Interopability disabled then Lando will treat it as a normal linux environment.

If you are looking to customize your install then advanced usage is for you.

Advanced ​

The installation script has various options but you will need to download the script and invoke it directly.

bash
# save the script
curl -fsSL https://get.lando.dev/setup-lando.sh -o setup-lando.sh

# make it executable
chmod +x ./setup-lando.sh

# get usage info
bash setup-lando.sh --help

Usage ​

bash
Usage: [NONINTERACTIVE=1] [CI=1] setup-lando.sh [options]

Options:
  --arch           installs for this arch [default: x64]
  --dest           installs in this directory [default: ~/.lando/bin]
  --fat            installs fat cli 3.21+ <4 only, not recommended
  --no-setup       installs without running lando setup 3.21+ <4 only
  --os             installs for this os [default: linux]
  --syslink        installs symlink in /usr/local/bin [default: auto]
  --version        installs this version [default: stable]
  --debug          shows debug messages
  -h, --help       displays this message
  -y, --yes        runs with all defaults and no prompts, sets NONINTERACTIVE=1

Environment Variables:
  NONINTERACTIVE   installs without prompting for user input
  CI               installs in CI mode (e.g. does not prompt for user input)

Some notes on advanced usage:

  • If you are running in CI then --syslink will be assumed
  • If you have an existing installation of lando in /usr/local/bin and can write to that location then --syslink will be assumed
  • If you want to customize the behavior of lando setup use --no-setup and then manually invoke lando setup after install is complete.
  • If you run in a non-tty environment eg GitHub Actions then --yes will be assumed
  • If you use --yes it is equivalent to setting NONINTERACTIVE=1

Environment Variables ​

If you do not wish to download the script you can set options with environment variables and curl the script.

bash
LANDO_VERSION=stable
LANDO_INSTALLER_ARCH=auto
LANDO_INSTALLER_DEBUG=0
LANDO_INSTALLER_DEST="~/.lando/bin"
LANDO_INSTALLER_FAT=0
LANDO_INSTALLER_OS=linux
LANDO_INSTALLER_SETUP=auto
LANDO_INSTALLER_SYSLINK=auto

Examples ​

These are equivalent commands and meant to demostrate environment variable usage vs direct invocation.

bash
# use envvars
LANDO_VERSION=3.23.11 \
LANDO_INSTALLER_DEBUG=1 \
LANDO_INSTALLER_SYSLINK=1 \
  /bin/bash -c "$(curl -fsSL https://get.lando.dev/setup-lando.sh)"

# invoke directly
bash setup-lando.sh --version "3.23.11" --debug --syslink