1. WSL2 Setup

Xprize Rainforest competition is a five year competition aimed at enhancing our understanding of the Rainforest ecosystem. It involves teams using technology to capture as much ecological information as possible with minimal interference to the forest ecosystem.

Needed tools:

  1. WSL2

  2. VS Code

  3. Docker and/or Rancher Desktop

  4. Kutuma

Flowchart of processes

Installation of WSL2

WSL2 is needed to create a Linux environment to run the VS Code commands and Docker. Docker cannot run on a Windows computer without the WSL2 installed.

What is WSL?

Windows Subsystem for Linux WSL is a feature of Windows that allows you to run a Linux environment on your Windows PC, without the need for a separate virtual machine or dual booting. WSL enables developers to use the best of both Windows and Linux simultaneously. Without WSL one would need to run an operating system that behaves like a completely separate computer in an app window (virtual machine), or choosing a particular OS installed a priori during startup (dual booting).

WSL2, is the most up-to-date and widely supported version of the Linux distribution for windows.

WSL Installation

To install the WSL app, on your Windows PC, go to Start menu>Command Prompt and select Run as administrator.

Type the following code:

wsl --install

This command will enable the features necessary to run Windows Subsystem for Linux (WSL) and install the Ubuntu distribution of Linux.

Once you have installed WSL, follow the Linux Distro setup instructions to the end. You will need to create a user account and password for your newly installed Linux distribution. Take note of these credentials.

If the WSL does not start after following the above steps, go to Microsoft Store and install the WSL app. Additionally, also install the Ubuntu app from Microsoft store.

Open the ubuntu app, follow the Linux Distro setup instructions.

Reboot your computer.

Go to Start menu, or type “WSL” in the search bar. Click on the WSL icon.

A text-based user interface such as the one below should appear.

The WSL Interface

Other Troubleshooting steps

In case the WSL app is present from the Start menu but clicking it does not open up WSL, follow the steps here

The above steps may be used to solve the following message that appears when one is starting WSL2.

WSL2 Error

However, if the issue persists, one may involve setting the virtualization via Basic Input/Output System (BIOS) of your laptop. For example, this link shows how to enable virtualization of your HP laptop.

It is important to know the specific laptop model to understand how to perform virtualization using the BIOS setup since instructions can even differ across various models of the same brand.