Skip to content

WSL configuration

WSL will automatically mount all Windows drives under the /mnt/ directory followed by the drive letter.

For example, the C: drive will be accessible on /mnt/c/.

Windows permissions

In order to allow WSL to change Windows file permissions, the drives need to be mounted with the metadata option.

  1. Create or edit WSL config file by entering the below terminal command.
sudo nano /etc/wsl.conf
  1. Add the following content to the file, then save and exit.
[automount]
options = "metadata"
  1. Restart WSL for changes to take effect.

Proxy

If using a device that has a proxy server, such as a Defra device, you will need to configure WSL to work around the proxy to avoid network conflicts.

  1. Create or edit a .wslconfig in your Windows profile directory

  2. Add the following content to the file, then save and exit.

[wsl2]
networkingMode=mirrored
autoProxy=false
  1. Restart WSL for changes to take effect.