Skip to content

Dev: Prerequisites for Installing MyLA on Windows

Zhen Qian edited this page Aug 25, 2020 · 1 revision

Prerequisites for Installing MyLA on Windows

Windows Subsystem for Linux 2 (WSL 2 + Hyper-V)

Requirements: Windows 10 after May 2020 update, any version other than Windows 10 Home

  1. Follow these instructions to setup WSL2, VSCode, Ubuntu and Docker.
  2. Follow these tips for best practice. These include, placing the files within WSL2 (rather than on a local drive), using VSCode WSL extension.
  3. This also was a good reference to adding in a nice terminal and ZSH.
  4. Watch this video here for creating a Linux Dev environment on Windows. This video basically goes over steps 1 and 2 in the first 10 minutes. The rest is just useful tools. Especially the tips on Ditto (14:24) and .wslconfig (25:14)
  5. This page from Microsoft talks about managing configurations and .wslconfig which is useful if you don't want to look at the above video.
  6. This is also a good reference for building a python environment (Though you've probably already got this by now)
  7. TODO: Clean up these steps and remove outdated guides ;)
  8. Follow the rest of the steps in the README for installation and setup instructions.

VirtualBox without Hyper-V (For Windows 10 Home or older versions of Windows)

  1. Disable Hyper-V on Windows.
  2. Install VirtualBox.
  3. Download Ubuntu.
    a. Use Ubuntu 18.04.3 LTS. Ubuntu 12.04 LTS does not work properly with Docker.
  4. Create and Run a Linux Virtual Machine (VM) using VirtualBox.
  5. Log in on your Linux VM.
  6. Install Docker. sudo apt install docker.io
  7. Start and enable Docker. sudo systemctl start docker && sudo systemctl enable docker
  8. Install docker-compose.
    a. Remove previous installation (if needed). sudo apt-get remove docker-compose
    b. sudo curl -L "https://github.com/docker/compose/releases/download/1.25.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
    c. sudo chmod +x /usr/local/bin/docker-compose
    d. sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
  9. Install Git.