diff options
| author | Ed Rochenski <edrochenski@users.noreply.github.com> | 2020-04-08 16:15:55 -0400 |
|---|---|---|
| committer | Andreas Kling <kling@serenityos.org> | 2020-04-09 11:35:43 +0200 |
| commit | 551cafe4d3dc04620fa2468d53f922398daae76d (patch) | |
| tree | 18b453cde34694181fd21f75f9e0a5388f8edb9b /Documentation/NotesOnWSL.md | |
| parent | 932de565b1dd79e44de2cb5f2bfbe85aad2fd38a (diff) | |
| download | serenity-551cafe4d3dc04620fa2468d53f922398daae76d.zip | |
Documentation: added additional info about moving to wsl2
Diffstat (limited to 'Documentation/NotesOnWSL.md')
| -rw-r--r-- | Documentation/NotesOnWSL.md | 7 |
1 files changed, 6 insertions, 1 deletions
diff --git a/Documentation/NotesOnWSL.md b/Documentation/NotesOnWSL.md index 29afb82d28..f5df346b83 100644 --- a/Documentation/NotesOnWSL.md +++ b/Documentation/NotesOnWSL.md @@ -4,7 +4,12 @@ SerenityOS can also be built and run under WSL Version 2. WSL Version 1 is not s 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. -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. +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: +- `wsl -l -v` will list distros and versions,<br/> +- `wsl --set-version <distro> <version` is used to convert a distro to another version, and<br/> +- `wsl --set-default-version 2` will set the default version for all new distros (if desired.)<br/> + +The installation then proceeds as usual. 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: |