Get Started Guide

  • 2022.3
  • 10/23/2022
  • Public Content

Set Up Windows* Subsystem for Linux* (Optional)

You can use the Windows* Subsystem for Linux* (WSL) if you don’t want to install a standalone Ubuntu* machine.
  • Minimum Windows 10 is required.
    To check your windows version, press the
    Windows logo key + R
    . Type
    and select
  • You must have at least 40 GB storage available.


  1. Open Windows PowerShell*.
  2. Run the following command to install the Ubuntu 20.04 distribution:
    wsl --install -d Ubuntu-20.04
    As a result, Ubuntu 20.04 will start and in a few minutes a pop-up window will ask you for username and password. After the install ends, the pop-up window is a Ubuntu 20.04 terminal.
    You must follow the instructions in the order shown to complete the installation successfully.
  3. If your machine is behind a proxy network, make sure you set proxies for
    and for the system. If your machine is not behind a proxy, you can skip this step.
    Replace the http/https links and ports in the commands presented below with your proxies links and ports.
    1. Set up apt proxies:
      sudo touch /etc/apt/apt.conf.d/proxy.conf sudo echo "Acquire::http::proxy \"http://http_proxy_link:http_proxy_port/\";" | sudo tee -a /etc/apt/apt.conf.d/proxy.conf sudo echo "Acquire::https::proxy \"http://https_proxy_link:https_proxy_port/\";" | sudo tee -a /etc/apt/apt.conf.d/proxy.conf
    2. Add your proxy settings to
      and to
      as well for http, https and no_proxy.
      http_proxy=http://<http_proxy_link>:<http_proxy_port> https_proxy=http://<https_proxy_link>:<https_proxy_port> no_proxy=localhost,, hostIp
    3. Reboot from the Windows PowerShell by using the following steps:
      1. Open another Windows PowerShell as administrator and run the following command:
        Get-Service LxssManager | Restart-Service
      2. In the user Windows PowerShell, run the following command to relaunch Ubuntu:
        wsl -d Ubuntu-20.04
      3. At this point, Windows PowerShell will give access to Ubuntu and the prompt should look like this:
  4. Update your Ubuntu distribution with the command:
    sudo apt-get update && sudo apt-get upgrade -y
  5. Install git and apply systemctl required changes:
    sudo apt-get install git git clone cd ubuntu-wsl2-systemd-script sudo ./
  6. Install terminator to have it as default terminal:
    sudo apt-get install terminator
  7. Set up Windows RDP in order to cover the Reference Implementation prerequisites where you need GUI.
    1. Install
      with the command:
      sudo apt-get install -y xfce4 xfce4-goodies
    2. Install
      with the command:
      sudo apt-get install -y xrdp
    3. Configure
      with the following commands:
      1. Comment the last two lines, add
        at the end of the following file, and save:
        sudo nano /etc/xrdp/
      2. Copy the original
        file as
        sudo cp /etc/xrdp/xrdp.ini /etc/xrdp/xrdp.ini.bak
      3. Change the xrdp port to not have a conflict with Windows OS port and complete configuration by running the following commands:
        sudo sed -i 's/3389/3390/g' /etc/xrdp/xrdp.ini sudo sed -i 's/max_bpp=32/#max_bpp=32\nmax_bpp=128/g' /etc/xrdp/xrdp.ini sudo sed -i 's/xserverbpp=24/#xserverbpp=24\nxserverbpp=128/g' /etc/xrdp/xrdp.ini echo xfce4-session > ~/.xsession
      4. Enable
        sudo systemctl start xrdp sudo /etc/init.d/dbus start sudo /etc/init.d/xrdp start
  8. Install missing component with the command:
    sudo apt-get install -y zenity
  9. Open Remote Desktop Connection Windows application and type
    for “Computer” and connect. Login with the username and password from step 1.
  10. After login, click on
    Use Default Config
  11. Set up for Reference Implementations.
    1. Run
      source /etc/environment
      if you are behind a proxy.
    2. Install your preferred browser. This example uses Firefox*.
      sudo apt-get install -y firefox
    3. Create a Docker group and add your user to the group with the commands:
      sudo groupadd docker sudo usermod -aG docker $USER
    4. Log out and reconnect via the Remote Desktop Connection Windows application.
  12. Open a terminal and start a web browser in the background. This example uses Firefox.
    1. Enter the command:
      firefox &
    2. Open the <RI link>.
    3. Download the recommended archive.
    4. In the terminal, run the command:
      cp <archive> ~/
    5. Unzip the archive and install.
To delete the distro, use the command:
wsl --unregister Ubuntu-20.04

Known Limitations

  1. If you receive the Docker error
    , you may need to create an account for Docker Hub. After that, login using your credentials:
    sudo docker login
  2. GPU and VPU are not available in WSL. The RI can be launched only on CPU.
  3. Disable screen lock on WSL to avoid lockup:
    gsettings set org.gnome.desktop.screensaver lock-enabled false

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at