Skip to content

Files

Latest commit

53576a7 · Nov 8, 2023

History

History

wsl

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Nov 8, 2023

Install

To install wsl on Windows, first you need to enable wsl feature in the setting.

If you are on Windows 11 22H2 or newer, you can enable wsl with single command without a distribution.

wsl --install --no-distribution

Otherwise follow the procedure of installing wsl on old Windows.
you need to do steps before the installation of distros.

Export/Import

To export an image of your wsl instance, do the following on Windows.

wsl --export <Distribution Name> <FileName>

It will make a tar file that has an image of your instance. To export a tar file, do this:

wsl --import <Distribution Name> <InstallLocation> <FileName>

You can find more about the basic commands here.

wsl.conf

wslconfig lets you config how each wsl instance work. It requires you write /etc/wsl.conf inside your wsl instance. Note that you need super user privileges to edit the file.

wsl appends useful Windows paths to wsl instances' "PATH" env by default. If you do not want this behavior, add this to /etc/wsl.conf in your wsl instance. This may also affect performance since the system needs to search excessive Windows paths. See this Github issue for more information.

[interop]
appendWindowsPath = false

If you want systemd, add this.

[boot]
systemd=true

If you want to edit the default login user, Do this:

[user]
default=dlguswo333

Useful Config

Add these lines to your shell config if you want vscode and explorer.exe in your Linux shell. This is particularly useful if you disable appendWindowsPath but need some of them.
Note that aliasing code as .../Microsoft VS Code/Code.exe is going to execute in wsl.localhost, not in WSL folder mode. It will have extensions on Windows enabled, not Linux's ones. See microsoft/vscode-remote-release#8009 for more infos.

# Alias Windows executables for wsl
alias code="/mnt/c/Users/dlguswo333/AppData/Local/Programs/Microsoft\ VS\ Code/bin/code"
alias explorer="/mnt/c/Windows/explorer.exe"