DEV Community

Cover image for Lando + WSL2 via Hyperdrive
James Candan
James Candan

Posted on • Edited on

Lando + WSL2 via Hyperdrive

UPDATE 7/8/2024

Lando has released v3.21.0! This includes a backport of Lando 4 installation process and plugin handling. Hyperdrive--Lando's previous install script helper--is no longer needed.

It also seems Lando has removed the "Setup Lando on Windows with WSL2" article. So, you'll have to rely on Microsoft's own How to install Linux on Windows with WSL.

Only recently, WSL2 was made default, run wsl -l -v to ensure you are running WSL2. If not, you need to follow Upgrade version from WSL 1 to WSL 2.

All you need to do is:

  1. Get WSL2 (see above).
  2. Open the Windows Store and get the latest Ubuntu (e.g. 22.04).
  3. Follow the Linux link within Lando's Installation in a WSL2 Linux Environment.

This is the final update this article will receive. I hope it was helpful!

UPDATE 9/15/2023

  • Hyperdrive supported up to Ubuntu 18.04.
  • Docker Engine supports Ubuntu 20.04+.

Suggestions to get Lando on Windows via WSL2:

  1. Get WSL2. Typically WSL1 is default, you need to be sure to follow the Windows docs to get WSL2.
  2. Get Ubuntu 20.04 or 22.04 via the Windows Store.
  3. Follow Docker's Install using the Apt repository.
  4. Follow the Then, Get The Latest Lando section below.
  5. You may additionally wish to update curl and git, and configure your git user and SSH keys.

UPDATE 6/7/2022

Updated the command lines to be copy/paste-ready for Ubuntu terminal in Windows. I noticed that it had trouble with the multi-line commands broken up by the back-slash (\) character.

Also, added a section to handle Docker version updates.

Intro

Falling short

If you've recently followed the awesome instructions to Setup Lando on Windows with WSL2, then you may have noticed your version of Lando is quite behind, or may not have completely worked at all.

Hyperdrive hasn’t seen a lot of love, so while it’s super awesome, it’s not up-to-date. They’re about to revamp it to be even more awesome, but until then, we need to jump through a couple hoops to install the latest stable release of Lando.

While Hyperdrive is being revamped, we need to use the last stable version, v0.6.1. However, even that hadn't received a relatively recent change to the stable release link.

Here’s what you need to do.

First, Run Hyperdrive

If you've already run Hyperdrive, you likely won't need this step.

If it failed to complete, you may have missed the instruction to sudo apt --fix-broken install without any specified package. Once that's done, run it again. You'll find a working Hyperdrive install command below.

Follow the documentation if you want to change the customizations included below, but this will work for most folks. Pop a --vim flag on there too if you wish.

IMPORTANT!

Don't forget to change your name and email address. This is used to populate Git config.

curl -Ls https://github.com/lando/hyperdrive/releases/download/v0.6.1/hyperdrive > /tmp/hyperdrive; chmod +x /tmp/hyperdrive; /tmp/hyperdrive --name "YOUR NAME HERE" --email your.email@thisismyawesomedomainnameandyoucanthave.one -y
Enter fullscreen mode Exit fullscreen mode

Update Docker

It doesn't look like Hyperdrive grabs the latest Docker version. You may want to check if Lando supports the latest Docker, then use the following 3 commands to remove Docker and re-install the latest.

sudo apt-get remove docker docker-engine docker.io containerd runc -y; sudo apt-get update -y; sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y;
Enter fullscreen mode Exit fullscreen mode

Visit https://docs.docker.com/engine/install/ubuntu/ for resources on specifying Docker version if the latest is not yet supported by Lando.

Then, Get The Latest Lando

Head over to Lando Releases and make a note of the version from the latest stable release.

Copy/paste the command below into a text editor. Be sure to replace the Github releases link with the one from the releases page.

curl -f#SL -o /tmp/lando.deb https://github.com/lando/lando/releases/download/v3.18.0/lando-x64-v3.18.0.deb; sudo dpkg -i --ignore-depends=docker-ce /tmp/lando.deb; rm -f /tmp/lando.deb;
Enter fullscreen mode Exit fullscreen mode

Once you have made the edit to the command line above, run it.

That does it. Run lando version to see you are on the latest. Cheers!

Top comments (0)