Skip to main content
Skip table of contents

Requirements - Windows


Requirements

  • WSL2 (Windows Subsystem Linux) and an Ubuntu distribution (20.04 LTS) from the Microsoft Store must be installed.

  • Docker Desktop must be installed. Docker Desktop provides functionality for providing and executing applications in containers, which are based on images.

  • With Windows and Docker Desktop, a Linux (WSL2) is installed, which then serves as the host system for the smartWARE Evaluation Docker installation.

  • The Linux user used for the installation must belong to the Docker group. This can be checked with the command id -Gn "userName". When doing so, replace "userName" with the corresponding user name.

  • The Linux user must also belong to the sudo group, since root permissions are required. The computer requires Internet access for the installation.

  • The TCP ports 80 and 443 on the computer must not be in use (if they are in use, the ports must be changed in the smartWARE Evaluation before starting).

  • Windows Terminal (from the App Store) must be installed.

WSL(2) Installation

You must have Windows 10 version 2004 and later (build 19041 and later) or Windows 11 installed.
You can now install everything you need to run the Windows subsystem for Linux (WSL) by typing this command at an administrator PowerShell or Windows command prompt, and then restarting your computer.

Please check that the installed Ubuntu distribution is WSL type 2. To do this, open a PowerShell and enter the command "wsl -l -v". You will then receive a listing.

If the Ubuntu version is version 1, it must be converted to the version with the following command "wsl --set-version Ubuntu-20.04 2".

Please check that the installed Ubuntu distribution is set as default. To do this, open a PowerShell and enter the command "wsl -l". You will then receive a listing.

If the default is not set to Ubuntu, you can do this with the following command.

Note: If the user does not have administrator rights and the installation of Docker Desktop was performed with the help of a special admin user,

In this example, the Docker installation could only be performed by the administrator Install_FB. To run Docker with the normal user, it was necessary to add the user Niklas Hack later.
To do this, as an example, add the user as follows: YOUR_DOMAIN\user_name

Access denied!
Due to missing permissions, adding the user via the user interface may result in "Access denied!" is returned.
In this case, the user can be added to docker-users via a console, such as Windows PowerShell. This console must be run as administrator.

net localgroup docker-users "DOMAIN\your-user-id" /
ADDSomit the command from the above example is:
net localgroup docker-users "JUMO\Niklas.Hack" /ADD

The domain "JUMO" is only an example here, you must use the domain name of your network.

Then, if necessary, reboot Windows. Then open the Docker container → Settings → Resources → WSL INTEGRATION → Ubuntu-20.04 → Toggle/ Activate Latch.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.