Recent changes to WSL2 by Microsoft have made using Linux on Windows even more comfortable. I’ll describe some of the options and their use below.
Firstly, do you have WSL2 installed? If not, then this will help https://learn.microsoft.com/en-us/windows/wsl/install-manual#step-1—enable-the-windows-subsystem-for-linux
In order to best use WSL, you of course need to have a distribution installed. Ubuntu is one of the easiest and most common to install.
wsl --list --online #check what distros are available
wsl --install -d Ubuntu-24.04 #latest at the time of writing
Now that you have a distro installed, we have something to configure. There are 2 configuration files that customise the distribution experience under WSL2. wsl.conf and .wslconfig
wsl.conf contains per-distribution settings, whereas .wslconfig configures global settings for the WSL2 environment.
wsl.conf is stored in the /etc directory within the distribution.
.wslconfig is stored in your %UserProfile% folder.
.wslconfig
The .wslconfig file is in .ini format with the GA features found under section [wsl2]. There is also an [experimental] section for unreleased options.
Note: All options may not be available to you as they are Windows OS and WSL version dependent. You can reasonably assume if you are running Windows 11, 22H2 or higher that most of the options described below are available to you. This is not the complete list, just the one’s I have found to be quite useful
GA features that I find useful
Accessible via the [wsl2] section of the .wslconfig file
Key | Value | Notes |
memory | memory size (Mb, Gb) | Default is 50% of the windows memory. I find it useful to constrain the memory (in conjunction with the experimental memory release features below) |
processors | number | Default is the same as present in windows |
localhostForwarding | true/false | Default is true, this allows your WSL2 application to be accessible via localhost:port |
nestedVirtualization | true/false | Allow nesting inside WSL2, Windows 11+ |
networkingMode | string, NAT, mirrored | The default is NAT, mirrored turns on mirrored networking mode. Mirrored mode is a great addition for many of my use cases. |
firewall | true / false | Hyper-V firewall can filter WSL network traffic |
dnsTunneling | false | see the experimental section |
Experimental (though very useful) features
Accessible via [experimental] section of the .wslconfig file.
Key | Value | Notes |
autoMemoryReclaim | disabled | Default is disabled, but options list gradual and dropcache can dramatically return memory outside wsl2. I default to gradual. |
sparseVHD | false | When set to true new VHD’s are created as sparse saving considerable disk with all the overprovisioning issues. By default, i’m using sparse, but then again i’ve been using sparse filesystems for many years |
useWindowsDnsCache | false | If you have dnsTunneling turned on then this option allows you to use or ignore what windows dns may’ve cached |
hostAddressLoopback | false | if networkingMode is set to mirrored then the loopback 127.0.0.1 address can be used to access the host and the container depending on where the listening resource may be running – windows or wsl2. This is a great option if you want better sharing between windows and wsl2 distro. For example, i’ve had a mongo client on windows and mongo in wsl2 ubuntu. |
wsl.conf
As I mentioned above the /etc/wsl.conf within the distribution controls some interesting behaviours, especially on distro launch.
[boot]
systemd=true
Solves the problem where you’re reliant on systemd resources within your WSL2 distro. I normally have it turned on.
[automount]
Key | Value | Notes |
enabled | true / false | Allows windows fixed drives to be automatically mounted under /mnt (or where the root key points). I have this enabled by default |
root | /mnt | Where the mounts occur for auto mounted systems |
mountFsTab | true/false | Allow the /etc/fstab to be processed at WSL distro boot time. Great to get those SMB/NFS mounts going. I have this set to true as I use a lot of NFS in my test environment. |
Some things to note.
Windows disks are mounted using Drvfs and are by default case sensitive. You can override this behaviour for all or single drives. More information is available at Per-directory case sensitivity and WSL – Windows Command Line (microsoft.com)
[network]
Key | Value | Notes |
generateHosts | true/false | wsl will generate an appropriate /etc/hosts file based on the windows environment. I generally set this to true (the default). |
generateResolvConf | true/false | wsl will generate an appropriate list of dns resolvers. I generally set this to true (the default). |
hostname | string | This sets the hostname to be used within the distro. The default is the windows hostname, but this is useful if you run multiple WSL instances. |