Serenity Operating System
Documentation: added additional info about moving to wsl2
authored by
Ed Rochenski
and committed by
Andreas Kling
551cafe4
932de565
+6
-1
+6
-1
Documentation/NotesOnWSL.md
+6
-1
Documentation/NotesOnWSL.md
···
4
4
5
5
WSL Version 2 is currently only available for Insider Builds of Windows which are more unstable and prone to crashes. Therefore, running SerenityOS on WSL Version 2 and running Insider Builds, in general, is not recommended on production systems.
6
6
7
-
Nevertheless, here is a guide on how to [get an Insider Build](https://insider.windows.com/en-us/how-to-pc/) and how to [get WSL2](https://docs.microsoft.com/en-us/windows/wsl/wsl2-install). The installation then proceeds as usual.
7
+
Nevertheless, here is a guide on how to [get an Insider Build](https://insider.windows.com/en-us/how-to-pc/) and how to [get WSL2](https://docs.microsoft.com/en-us/windows/wsl/wsl2-install). Once installed, you will need to make sure the distribution you want to use (and the new default) is using Version 2:
8
+
- `wsl -l -v` will list distros and versions,<br/>
9
+
- `wsl --set-version <distro> <version` is used to convert a distro to another version, and<br/>
10
+
- `wsl --set-default-version 2` will set the default version for all new distros (if desired.)<br/>
11
+
12
+
The installation then proceeds as usual.
8
13
9
14
WSL2 does not natively support graphical applications. This means that to actually **./run** SerenityOS, you need an X Server for windows. [Vcxsrv](https://sourceforge.net/projects/vcxsrv/) is a good option. When you start up Vcxsrv, make sure to set the Display number to 0, and to Disable access control. Before actually doing **./run**, you need to set the DISPLAY environmental variable as such:
10
15