Mets Minor League Blog

Music theory, instruments and musicians

Mets Minor League Blog

Music theory, instruments and musicians

How to Install WSL on Windows 10 in Easy Steps

By metsPosted on Posted in Sport Gear

How to Install WSL on Windows 10 in Easy Steps

If you’re interested in running Linux environments directly on your Windows 10 system, installing the Windows Subsystem for Linux (WSL) is a powerful way to do so. WSL allows you to use Linux command-line tools, scripts, and applications seamlessly alongside your Windows applications, making it ideal for developers, system administrators, and tech enthusiasts who need both environments without dual-booting or virtual machines. This guide will walk you through the process step-by-step, ensuring a smooth installation experience. Before starting, ensure your Windows 10 version supports WSL 2, and your system is up to date.

What You’ll Need

  • Windows 10 version 1903 or higher (preferably 2004 or later for WSL 2 support)
  • Administrator privileges on your Windows account
  • Internet connection for downloading updates and Linux distributions
  • Optional: Windows Terminal for enhanced command-line experience

Step-by-Step

  1. Check your Windows version: Press Windows key + R, type winver, and hit Enter. Ensure your version is 1903 or higher. If not, update Windows via Settings > Update & Security > Windows Update.
  2. Enable the Windows Subsystem for Linux: Open PowerShell as Administrator (search for PowerShell, right-click, and select ‘Run as administrator’). Type the following command and press Enter: 
     dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

    Wait for the process to complete.

  3. Enable the Virtual Machine Platform (for WSL 2): In the same PowerShell window, run: 
     dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

    This step is necessary for WSL 2 support.

  4. Restart your computer: After enabling these features, restart your PC to apply changes.
  5. Set WSL 2 as your default version: Open PowerShell as Administrator again and run: 
     wsl --set-default-version 2

    This command ensures that any new Linux distributions installed will use WSL 2 by default.

  6. Download and install a Linux distribution: Visit the Microsoft Store, search for your preferred Linux distro (such as Ubuntu, Debian, or Fedora), and click Install. Alternatively, you can install via command line with commands like wsl --install -d Ubuntu (Windows 10 2004+).
  7. Launch your Linux distribution: Once installed, open the Start menu, find your Linux distribution (e.g., Ubuntu), and click to launch. The first time, it will take a few minutes to set up. You’ll be prompted to create a user account and password for your Linux environment.
  8. Update your Linux environment: After setup, run:
    9.  sudo apt update && sudo apt upgrade

    to ensure your Linux system is current and ready for use.

  9. Optional: Install Windows Terminal: For a better command-line experience, download Windows Terminal from the Microsoft Store. Open it, and you can add multiple tabs for PowerShell, Command Prompt, and your Linux distributions.

Common Mistakes

  • Skipping the restart after enabling features: Not restarting can prevent WSL from functioning correctly.
  • Using an unsupported Windows version: WSL 2 requires Windows 10 version 2004 or later; earlier versions won’t support WSL 2.
  • Not setting WSL 2 as default: If you want the latest features, ensure you run wsl --set-default-version 2.
  • Installing Linux distributions without checking compatibility: Some older distributions may not work well with WSL 2; verify compatibility first.

Tips

  • Keep your Windows updated to get the latest WSL improvements and features.
  • Use Windows Terminal for a more versatile and customizable command-line interface.
  • Explore the WSL configuration file (.wslconfig) to customize resource allocation and behavior.
  • Use wsl --list --verbose to see your installed distributions and their WSL version.
  • If you encounter issues, running wsl --shutdown can help reset the WSL environment.

Troubleshooting

If WSL does not install correctly or you encounter errors, try these solutions:

  • Ensure Windows is fully updated: Sometimes, missing updates prevent WSL from enabling properly. Check Windows Update and install all pending updates.
  • Re-enable features: Disable WSL and Virtual Machine Platform features, restart your PC, then re-enable them following the steps above.
  • Run the WSL troubleshooting script: Microsoft provides troubleshooting guides and scripts to diagnose common issues. Search for official WSL troubleshooting resources.
  • Check for Hyper-V conflicts: Hyper-V can sometimes interfere; ensure it is enabled if you plan to use Hyper-V features alongside WSL.
  • Reset the Linux distribution: If your Linux environment is behaving unexpectedly, uninstall and reinstall it from the Microsoft Store.

Frequently Asked Questions

1. Can I install WSL on Windows 10 Home?

Yes, Windows 10 Home supports WSL, but WSL 2 requires enabling the Virtual Machine Platform feature, which is available on Windows 10 version 2004 or later.

2. How do I switch between WSL 1 and WSL 2?

You can convert an existing distribution with wsl --set-version <DistroName> 1 or 2. Use wsl --list --verbose to see current versions.

3. Is WSL 2 faster than WSL 1?

Typically, yes. WSL 2 uses a real Linux kernel and offers improved performance, especially for file system operations and compatibility.

4. Can I run graphical Linux apps with WSL?

Yes, with WSL 2 and Windows 11, or with additional setup like an X server, you can run Linux GUI applications. Windows 10 support for GUI apps is evolving.

5. Do I need to install Linux separately after enabling WSL?

Yes, WSL provides the environment, but you must install a Linux distribution from the Microsoft Store or via command line.

6. How do I uninstall WSL if I no longer need it?

Disable the features in Windows Features, uninstall Linux distributions, and optionally delete WSL files from your system.

Following these steps and tips will help you set up WSL on Windows 10 efficiently, unlocking a powerful Linux environment right on your desktop for development, learning, or everyday use.

Related

How to Install WSL on Windows 10 in Easy Steps
Scroll to top