Installing Lando on Windows
Installing Lando on a Windows machine is easy. Just follow these 30 (or more) simple steps:
- Review the directions.
- Figure out which version of Windows you are running.
- Realize that you need to upgrade to Windows 10 Professional, because apparently you have to pay extra to actually do work on a Windows machine.
- Open the Windows Store.
- Spend half an hour trying to figure out why the Windows store is only showing blank pages.
- Take a break, go vote, spend some time with your kids, and seriously consider buying a Mac so that you don't have to deal with this shit.
- Reboot your computer and finally get Windows store to respond.
- Pay $100 dollars, while updating your account information because everything is three years out-of-date. Do not pass Go.
- Reboot your computer twice.
- Go to the Lando releases page.
- Spend some time looking for the last stable release (note: there is no spoon stable release).
- Download and run the latest
.exe
. - The installer will complain that you don't have Hyper V, which you just paid for.
- Find the obscure command you need to enable Hyper V.
- Find Powershell in the Start menu.
- Discover that you can paste into PowerShell just by right-clicking your mouse. This seems convenient, but it's a trap!
- Run the command. It doesn't work.
- Learn how to run PowerShell as an administrator.
- Run the command, again.
- Reboot your computer, again.
- Run the
.exe
, again. - The installer wants to install Docker. Let it.
- The Docker installer wants you to log you out. Let it
- Log back in.
- Open Babun and try the
lando
command. It isn't found. - Open Powershell and try the
lando
command. It isn't found. - Open the Command Prompt and try the
lando
command. It isn't found. - Re-run the Lando installer, for the third time. It turns out that it never finished because Docker logged you out.
- Open Powershell and try the
lando
command. - It works! Congratulations, you are done!*
* Just kidding...
- Open PowerShell. Go to the directory where you have your Drupal site.
- Run
lando init
. - Choose the
drupal 7
recipe. - Why is it asking for a Pantheon machine token? This isn't a Pantheon site! Hit Ctrl-C.
- Log into Pantheon, create a machine token for your Windows machine. note: Terminus and Lando are notorious for asking for this machine token over and over, so make sure to paste this machine token into a file somewhere, which kind of defeats the entire point of having a machine token.
- Run
lando init
, again. - Right clicking to paste doesn't work for the hidden machine token. So, learn a different way to paste the machine token into PowerShell.
- Congratulations, you are done!**
** Just kidding...
- Run
lando start
. Your terminal will proceed to spew error messages for several minutes. - Spend an hour searching through the Lando issue queue trying to find the magic sequence that will fix these errors.
- Go apple.com and start comparing the new MacBook Air to the new Mac Mini. Figure out if you can afford either one so that you don't have to deal with this shit.
- Your kids are picking up on your frustration, and everyone is melting down because it is bedtime (and your are anxious about the election).
- Give up for the night, and obsessively refresh the election results at fivethirtyeight.com until the results are clear at 11:00 PM.
- Get up the next morning and write a satirical article about installing Lando on your Windows machine.
I will let you know if I ever actually get it working.
Update November 19, 2018
I was finally able to get Lando working. Here is what I did:
- Deleted the "hidden" directory at
~\.lando
. - Uninstalled Docker and Lando with the Windows control panel.
- Downloaded and ran the latest version of Lando for Windows, which was lando-v3.0.0-rc.1.exe at the time I was writing this.
- The Lando installer also installed Docker, but Docker did not ask to log out this time. Also, Docker asked to install a newer version, which I did not allow.
- After a sucessful install, I used Powershell to navigate to the directory where I had my Drupal files.
- I removed the old version of
.lando.yml
. - I ran
lando init
, chose the Drupal 7 recipe, and provided the Pantheon machine token. I knew I was going to need to keep that! - I ran
lando start
. - During the start, Docker asked for permisson to "share" with the C: drive, which I granted. I don't remember having to do that before, but I might have forgotten.
- Also, during the start Windows Defender asked what to do about a Docker sub-program that wanted internet access. I definitely don't remember that. So, I gave it permission on both private and public networks, since I suspect that it was crucial and I am on public networks somewhat regularly.
- The command ran cleanly, and the site responded in a browser. So, I am finally done. No kidding
Update January 2, 2019
I continue to have problems when starting Lando, especially when switching from project to project. However, I have found that right-clicking on the Docker icon in the Taskbar and choosing Restart... clears up the errors. So, I recommend trying this first before nuking your entire setup.
Related Article(s)
Tags:
Original Article: