Skip to content

WSL

For Microsoft Windows environments, Quokka can be configured to run using WSL. WSL1 can be used with any editor while WS2 is only supported in VS Code. To find out which version you are using, run the terminal command wsl --list --verbose.

WSL 2

WSL2 is only supported if you use VS Code. You must first install Microsoft’s VS Code Remote WSL extension. Quokka will automatically use WSL2 when a remote WSL session is available.

There are two ways to start a VS Code WSL session:

  1. Open a WSL terminal for your installed Linux distribution and type code .
  2. Start VS Code, Press Ctrl+Shift+P and select Remote-WSL: New Window

After starting a remote WSL session, you must install the Quokka extension for your WSL distribution from the Extensions view. If you have a Quokka PRO license then you will also need to apply your license to your remote WSL distribution.

Please note that your Quokka global settings are not shared between your main desktop and your WSL distribution.

WSL 1

This configuration option is only available for your global Quokka config.json file. To use WSL, you must set useWsl to true, for example:

{
  "useWsl": true
}

This setting is ignored on non-Windows environments. If configuring a custom version of node, the path must refer to a version of node on your Linux installation.