Skip to content

Windows Guide

XternA edited this page Apr 4, 2024 · 7 revisions

On a Windows host, two prerequisite requirements need to be enabled.

  1. Virtualization - For running a virtualized environment on top of the host layer.
  2. WSL - For running the Linux subsystem on Windows.

We'll then leverage the Linux subsystem to run the tool in the Linux subspace. Docker in Windows also ideally runs everything in Linux space.

Virtualization

On most PCs that run Windows as the main operating system, you will need to enable Virtualization in the BIOS. Refer to this BIOS guide as a reference for ASUS motherboards to turn on this feature. For other motherboard brands, refer to your motherboard guide or look up your motherboard make and version.

Virtualization is needed to allow Docker to run on top as a hypervisor as it's essentially running a virtual environment underneath like a VM (Virtual Machine).

Windows Subsystem For Linux (WSL)

Since Windows 10 May 2020 (2004) it is possible to install WSL2 (Windows Subsystem For Linux) with just a single command and no hassle.

First, we'll need to set up the Windows Subsystem for Linux. To do this, open the command line as administrator. Run these commands to install WSL:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

After the operation finishes, restart Windows. Then, open the command line as administrator, and run this command:

wsl --set-default-version 2

Now on the command line type:

wsl --install

This will configure and install WSL2 with Ubuntu as the distro.

Once installed, just simply type:

wsl

This will switch from the Windows terminal to the Linux shell terminal. Now you're basically in Linux.

Configure your username and password.

Docker Installation

Unlike Linux and macOS. Docker will need to be pre-installed first before using the tool. This is to make things easier to work with later on. Despite WSL on Windows being a full-fledged Linux distribution, it does differ slightly. Even though the image used is Ubuntu, it won't be possible to install Docker from Ubuntu using the apt. It will need to resort to Windows space and use Winget.

Another point is that we can run the tool entirely in the Linux subsystem instead of running a Windows script and then changing it to Linux space. This also means not needing to port the tool to Windows instructions as everything underlying is running on Linux either way.

Refer to the Docker Installation guide section for Windows to install Docker.

Clone this wiki locally