Install WSL (Windows Subsystem for Linux)

To run Mudfish in a Windows WSL environment, you must first install the Windows Subsystem for Linux (WSL).

How to install WSL

There are a number of blogs and articles on the internet that explain how to install WSL in a straightforward manner, so please refer to them. Here are some links to articles that you might find helpful.

• How to install Linux on Windows with WSL
• How to Install WSL 2 on Windows 10
• How to install WSL2 (Windows Subsystem for Linux 2) on Windows 10

Caution

Please install a Linux distribution based on Ubuntu. Ubuntu 20.04 LTS is the current recommended version.

Enable WSL interop feature

The interop feature must be enabled for Mudfish WSL support to work properly.

In your environment, make sure to check the /etc/wsl.conf file for an [interop] section.

If it is set up properly, it usually looks like this

$ cat /etc/wsl.conf
[boot]
systemd=true

[interop]
enabled=true

If it doesn't exist, you need to insert it manually as follows:

$ echo "[interop]" >> /etc/wsl.conf
$ echo "enabled=true" >> /etc/wsl.conf

WSL Check-List

Once you've installed and configured WSL, you'll want to double-check the following items.

1. Is the WSL installation correct?
2. You have an Ubuntu-based Linux installation. Ubuntu 20.04 LTS is currently the recommended distribution for Mudfish. Although other versions are fine.
3. Is the [interop] section in /etc/wsl.conf properly configured.