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
- 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
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.
- Docker Engine for Linux requirements
- Docker Desktop for Mac requirements
- Docker Desktop for Windows requirements
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!!!.
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
- Verify that your system meets the minimum system and hardware requirements to run Lando.
- Verify that you are connected to the internet.
- Verify that you have administrative access to your machine.
Optional checks
- If you already have Docker installed it needs to be set to factory defaults.
- 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!
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
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.
HomeBrew (third party)
Install viaWe 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 GitHub. 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.rb
- Ensure homebrew is installed and up-to-date.
- Add the lando cask:
brew install --cask lando
Linux
Install package via direct download (recommended)
- Install the Docker Community Edition for your Linux version. Visit https://get.docker.com for the "quick & easy install" script. (at least version 19.03.1-ce)
- Download the latest
.deb
,.pacman
or.rpm
package from GitHub - Double click on the package and install via your distributions "Software Center" or equivalent.
- 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-engine
Arch
Lando is also available on the AUR as lando-git, 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 this for more details.
If your distro uses SystemD, make sure that both
docker.service
anddocker.socket
daemons are running.If you are using Manjaro or another Arch-based distro, you may need to enable the AUR repository for dependencies.
Windows
YOU MUST HAVE WSL2 ENABLED
Make sure that the WSL2 feature is enabled or the Lando installer will fail.
If you want to use the older Hyper-V 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!
- 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 install
From source
To install from source you need to first make sure you've manually installed the below dependencies:
- the latest stable version of docker for your operating system, set to its factory defaults.
- the latest node 16
- the latest yarn
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