Installation And Setup Microsoftdocs Wsl Deepwiki

Loading... Loading... Menu This document describes the simplest method to install Windows Subsystem for Linux (WSL) on recent versions of Windows. WSL enables you to run a Linux file system, along with Linux command-line tools and GUI apps, directly on Windows, alongside your traditional Windows desktop and applications. For manual installation on older Windows versions, see Manual Installation.

Before installing WSL, ensure your system meets these requirements: - Windows 10 version 2004 or higher (Build 19041+) or Windows 11 - A computer with virtualization capabilities enabled in BIOS/UEFI - Administrator access to your Windows computer You can check your Windows version by running winver from the Run dialog (Windows key + R).

Sources: WSL/install.md14-16 Sources: WSL/install.md19-26 WSL/setup/environment.md28-34 To install WSL with a single command, open PowerShell or Windows Command Prompt in administrator mode (right-click and select "Run as administrator") and run: wsl --install This command performs the following tasks: - Enables the required Windows features (WSL and Virtual Machine Platform) - Downloads and installs the latest Linux kernel - Sets WSL 2 as the default version - Downloads and installs the Ubuntu distribution (default) A system restart will be required during the installation process.

If you prefer a different Linux distribution, you can specify it using the -d flag: wsl --install -d <Distribution Name> To see available distributions: wsl --list --online Or in shorter form: wsl -l -o Sources: WSL/install.md38-44 Once installed, WSL consists of several interconnected components: Sources: WSL/install.md10-13 WSL/faq.yml16-19 When you first launch your newly installed Linux distribution, a console window will open and you'll need to: - Wait for the files to decompress and be stored on your machine (this only happens on first launch) - Create a UNIX username and password when prompted - This username and password is specific to your Linux distribution - It's completely separate from your Windows username and password - The password input will not be visible as you type (blind typing) - The account will have administrator privileges with the ability to use sudo Sources: WSL/install.md31-32 WSL/setup/environment.md42-56 Once your Linux distribution is installed, it's recommended to update the packages using the distribution's package manager.

For Ubuntu or Debian-based distributions: sudo apt update && sudo apt upgrade This ensures your Linux distribution has the latest security updates and software versions. Sources: WSL/setup/environment.md73-78 To verify that WSL has been installed correctly and to check which version (WSL 1 or WSL 2) your distribution is using: wsl -l -v This will list all installed Linux distributions and show which WSL version each is configured to use.

Sources: WSL/install.md61-64 To see general information about your WSL configuration: wsl --status This shows information such as the default distribution, WSL version, and kernel version. Sources: WSL/basic-commands.md106-110 For a better command-line experience, it's recommended to install Windows Terminal, which provides a modern terminal interface with tabs, split panes, and customization options. Windows Terminal can be installed from the Microsoft Store.

Sources: WSL/setup/environment.md87-105 For optimal performance: - Store project files in the Linux file system if working with Linux tools - Access Linux files from Windows via the network path: \\wsl$\<DistroName>\home\<UserName>\ - Avoid storing development files in Windows file system ( /mnt/c/ ) when working with Linux tools, as this can cause performance issues Sources: WSL/setup/environment.md108-117 If running wsl --install displays the WSL help text, WSL might already be partially installed.

Try: wsl --list --online Then install a specific distribution with: wsl --install -d <DistroName> Sources: WSL/install.md33-35 This error occurs when WSL is blocked by a group policy. Try: - Run wsl --update to update to the latest Store version - If that doesn't resolve the issue, contact your system administrator Sources: WSL/faq.yml299-301 If you encounter other issues during installation, refer to the Troubleshooting wiki page for more detailed guidance.

After successful installation, consider these next steps: - Set up a development environment with your preferred tools and configurations - Install code editors like Visual Studio Code or Visual Studio - Set up version control with Git - Configure databases or other development tools - Explore WSL command-line interface to learn available commands Sources: WSL/install.md56-58 WSL/setup/environment.md120-190 Refresh this wiki - Basic Installation - Prerequisites - Installation Process - Basic Installation Workflow - Simple Installation Command - Changing the Default Linux Distribution - System Components - First-Time Setup - Setting Up User Account - Updating Packages - Verifying Installation - Check WSL Version - Check WSL Status - Additional Setup Options - Installing Windows Terminal - File Storage Considerations - Troubleshooting Common Installation Issues - Installation Command Shows Help Text - Error: 0x800704ec - Program Blocked by Group Policy - Additional Resources - Post-Installation Next Steps

People Also Asked

• Installation and Setup | MicrosoftDocs/WSL | DeepWiki
• Install WSL | Microsoft Learn
• WSL/WSL/install.md at main · MicrosoftDocs/WSL · GitHub
• Basic Installation | MicrosoftDocs/WSL | DeepWiki
• Set up a WSL development environment | Microsoft Learn
• MicrosoftDocs/WSL | DeepWiki
• How to Install WSL2 on Windows 11: A Step-by-Step Guide for Beginners