WSL on Windows

When running the above DevContainer setup on Windows, you might experience very slow performance when doing operations like “npm install”. This is because of the filesystem, that has to be synchronized between Windows and the Linux DevContainer. To alleviate this issue, the DevContainer can be run through Ubuntu (running on WSL 2). The steps for installing such a setup, is given below. This guide assumes that Docker and Visual Studio Code (VSCode) is installed.

  1. Install the following two extensions for VSCode

  2. Open Microsoft Store on Windows, and download and install Ubuntu (22.04.3 LTS or newer)

  3. Open Ubuntu by using Windows Start Button >> Ubuntu

  4. A terminal will prompt you for credentials for a new user (enter to your liking)

  5. In the terminal run sudo apt install unzip

  6. In Windows explorer, find the Ubuntu “user home” folder. First enter \\wsl$\Ubuntu\home in Window Explorer and then navigate to Ubuntu and then into the folder with the username created in step 4.

  7. Copy the SDK zip file from you windows to the “user home” folder.

  8. Now in the Ubuntu terminal, navigate to the folder, that now contains the copied web-sdk zip file, by writing cd ~/

  9. Unzip the SDK zip file by writing unzip polyscopex.zip

  10. In Docker Desktop settings, enable the Ubuntu under Resources >> WSL integration intellij gutter icon

  11. In the Ubuntu terminal, go into the unzipped folder cd polyscopex

  12. In the Ubuntu terminal, start VSCode with code .

  13. In VSCode Choose “re-open in container”

Now VSCode opens the DevContainer and runs in Ubuntu. If any problem arises, see installation troubleshooting.