Installation using WSL2

This installation method is not recommended for production environments.

ArmoniK can be installed on Windows 10 and 11 using the Windows Subsystem for Linux. The following instructions will guide you through the installation process.

You can read more about WSL2 on the Microsoft documentation.

Install WSL2

You must stop Docker Desktop before installing WSL2. Removing Docker Desktop is not required but recommended.

To install WSL2, open the Windows Store and install the Windows Subsystem for Linux application.

If you are unable to use the store version, please refer to the Microsoft documentation. Please, install WSL2 (not WSL1). We do not support WSL1.

Install Ubuntu LTS

Currently, the LTS is the version 22.04.

Then you can install the Ubuntu distribution from the Windows Store. We recommend you to install the latest LTS version.

You can also install Ubuntu LTS manually by following the instructions.

powershell
wsl --install -d Ubuntu
You can read more about Ubuntu on the Microsoft documentation.

Once the installation is complete, verify the version of Ubuntu:

powershell
wsl -l -v

You should see something like this:

powershell
  NAME     STATE           VERSION
* Ubuntu   Running         2
# or Ubuntu-22.04 depending if you install the LTS or a specific version

You can set the default WSL2 distro by using the following command:

powershell
wsl --set-default Ubuntu # or Ubuntu-22.04 depending if you install the LTS or a specific version

Then, you can start your Ubuntu distribution:

powershell
wsl -d Ubuntu # or Ubuntu-22.04 depending if you install the LTS or a specific version

Finally, you can update your packages:

shell
sudo apt update && sudo apt upgrade -y

Configure WSL2

Take a look on how to configure the installation with WSL2 and systemd.

In order to have Docker and Kubernetes, we need to use systemd. WSL2 supports systemdnatively but it is not enabled by default.
Edit this page on GitHub
Table of Contents