{"id":21028,"date":"2024-11-21T21:43:17","date_gmt":"2024-11-21T20:43:17","guid":{"rendered":"https:\/\/contabo.com\/blog\/?p=21028"},"modified":"2026-05-27T22:19:24","modified_gmt":"2026-05-27T20:19:24","slug":"how-to-install-wsl2-on-windows-11","status":"publish","type":"post","link":"https:\/\/contabo.com\/blog\/how-to-install-wsl2-on-windows-11\/","title":{"rendered":"How to install Windows Subsystem for Linux 2 on Windows 11"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n
<\/div>\n\n\n\n

Windows Subsystem for Linux 2 (WSL2) is Microsoft’s powerful virtualization layer that lets you run a full Linux environment directly on Windows 11 without dealing with dual-boot headaches or clunky virtual machines. Need to install WSL2 for Docker development, run Linux CLI tools, or manage servers? WSL2 on Windows 11 delivers near-native performance while keeping everything integrated in 2026. <\/p>\n\n\n\n

WSL 2 is a massive leap forward from the original version. You get full Linux kernel compatibility, faster file-system performance, and Docker container support right out of the box. Linux applications can tap into Windows files and the other way around, making cross-platform development surprisingly smooth. <\/p>\n\n\n\n

This guide covers everything you need to install WSL2 on Windows 11 in 2026, step by step. We’ll check system requirements, enable the right features, help you pick a Linux distribution like Ubuntu or Debian, optimize performance, and fix common problems. Works whether you’re running Windows 11 Home or Pro. <\/p>\n\n\n\n

What Is WSL2 and Why Use It on Windows 11?<\/strong><\/h2>\n\n\n\n

WSL2 (Windows Subsystem for Linux 2) is a compatibility layer baked into Windows that runs an actual Linux kernel inside a lightweight virtual machine. The original WSL 1 translated Linux system calls, but WSL 2 ships a real kernel. That means full system-call compatibility, dramatically faster file I\/O, and native support for tools like Docker. <\/p>\n\n\n\n

For developers, IT professionals, and Linux enthusiasts on Windows 11, WSL2 kills the need for dual-boot setups or resource-hungry virtual machines. You get a complete Linux environment sitting right next to your Windows desktop. Run bash scripts, develop in VS Code with remote containers, manage servers, and use all your favorite Linux tools without ever leaving Windows. <\/p>\n\n\n\n

WSL2 System Requirements and Preparation<\/strong><\/h2>\n\n\n\n

Before you install WSL2 on Windows 11, your machine needs to meet these specs: <\/p>\n\n\n\n

    \n
  • Windows 11 (Home, Pro, or Enterprise) with all updates installed\u00a0<\/li>\n\n\n\n
  • A 64-bit processor with virtualization support (Intel VT-x \/ AMD-V)\u00a0<\/li>\n\n\n\n
  • At least 4 GB of RAM (8 GB works better)\u00a0<\/li>\n\n\n\n
  • Minimum 5 GB of free disk space\u00a0<\/li>\n<\/ul>\n\n\n\n

    Pro Tip<\/strong>\u00a0
    To verify virtualization is enabled: Open Task Manager (Ctrl + Shift + Esc), click the Performance tab, and look at the ‘Virtualization’ status. And yes, WSL2 on Windows 11 Home is fully supported. You don’t need the Pro edition.<\/em><\/p>\n\n\n\n

    \"\"\/<\/figure>\n\n\n\n

    How to Install WSL2 on Windows 11: Quick PowerShell Method<\/strong><\/h2>\n\n\n\n

    The fastest route to install WSL2 on Windows 11 is one PowerShell command. Here’s the process: <\/p>\n\n\n\n

      \n
    1. Open PowerShell as administrator (right-click Start, then choose “Windows Terminal (Admin)”<\/strong> or “PowerShell (Admin)”<\/strong>)\u00a0<\/li>\n\n\n\n
    2. Run the install wsl2 command:\u00a0<\/li>\n<\/ol>\n\n\n\n
      wsl --install<\/code><\/pre>\n\n\n\n
      This install wsl2 command wsl –install automatically handles: <\/p>\n\n\n\n
        \n
      • Enabling required Windows features (Virtual Machine Platform, Windows Subsystem for Linux)\u00a0<\/li>\n\n\n\n
      • Downloading the latest WSL2 kernel\u00a0<\/li>\n\n\n\n
      • Setting WSL 2 as the default version\u00a0<\/li>\n\n\n\n
      • Installing Ubuntu as your default Linux distribution\u00a0<\/li>\n<\/ul>\n\n\n\n
        Important<\/strong> 
        Once the installation wraps up, restart your computer. The WSL2 setup won’t finish without it.<\/em> <\/p>\n\n\n\n
        Choosing Your Linux Distribution for WSL2<\/strong><\/h2>\n\n\n\n
        The wsl –install command picks Ubuntu by default, but Windows 11 supports plenty of Linux distributions through WSL2. Here are some solid options:<\/p>\n\n\n\n
        Distribution<\/strong><\/td>Best For<\/strong>\u00a0<\/td>Command<\/strong><\/td><\/tr>
        Ubuntu<\/td>beginner-friendly default choice\u00a0<\/td>wsl \u2013install -d Ubuntu<\/em><\/td><\/tr>
        Debian<\/td>lightweight and stable\u00a0<\/td>wsl \u2013install -d Debian<\/em><\/td><\/tr>
        Kali Linux<\/td>built for penetration testing\u00a0<\/td>wsl \u2013install -d kali-linux<\/em><\/td><\/tr>
        Fedora<\/td>bleeding-edge packages\u00a0<\/td>wsl \u2013install -d Fedora<\/em><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
         
        Want to see every available distribution? Run this: <\/p>\n\n\n\n
        wsl --list --online<\/code><\/pre>\n\n\n\n
         
        Pick your distro and install it with: <\/p>\n\n\n\n
        wsl --install -d <DistroName><\/code><\/pre>\n\n\n\n
        Pro Tip<\/strong> 
        You can actually run multiple distributions at once on WSL2. Great for testing applications across different Linux environments. Still deciding which distro fits your needs? Our Comprehensive Guide to Operating Systems breaks down the differences.<\/em> <\/p>\n\n\n\n
        Key WSL2 Management Commands\u00a0<\/strong><\/h2>\n\n\n\n
        These PowerShell commands will help you manage your WSL2 installation on Windows 11: <\/p>\n\n\n\n
        See What’s Available<\/strong><\/h3>\n\n\n\n
        Shows every Linux distro you can download and install through WSL2. <\/p>\n\n\n\n
        wsl --list --online\u00a0<\/code><\/pre>\n\n\n\n
        Check if WSL2 is Installed\u00a0<\/strong><\/h3>\n\n\n\n
        Lists all installed distributions with their running state and WSL version. Use this to check if WSL2 is installed and confirm which version each distro is using. <\/p>\n\n\n\n
        wsl --list --verbose\u00a0<\/code><\/pre>\n\n\n\n
        Make WSL 2 the Default<\/strong><\/h3>\n\n\n\n
        Forces all new distributions to use WSL 2 instead of WSL 1. <\/p>\n\n\n\n
        wsl --set-default-version 2\u00a0<\/code><\/pre>\n\n\n\n
        Update WSL2 Windows 11<\/strong><\/h3>\n\n\n\n
        Grabs the latest WSL2 kernel update from Microsoft. Run this regularly to update WSL2 Windows 11 and keep current with performance improvements and security patches. <\/p>\n\n\n\n
        wsl --update\u00a0<\/code><\/pre>\n\n\n\n
        Stop Everything\u00a0<\/strong><\/h3>\n\n\n\n
        Kills all running WSL2 instances immediately. Handy before making config changes or when troubleshooting problems. <\/p>\n\n\n\n
        wsl --shutdown\u00a0<\/code><\/pre>\n\n\n\n
        WSL2 File System Integration on Windows 11\u00a0<\/strong><\/h2>\n\n\n\n
        WSL2’s file system integration between Linux and Windows is genuinely useful. Here’s how it works: <\/p>\n\n\n\n
        Accessing Windows Files from Linux<\/strong><\/h3>\n\n\n\n
        Your Windows drives mount automatically under \/mnt\/ in WSL2. Your C drive lives at: <\/p>\n\n\n\n
        cd \/mnt\/c\/\u00a0<\/code><\/pre>\n\n\n\n
        Accessing Linux Files from Windows\u00a0<\/strong><\/h3>\n\n\n\n
        Type \\\\wsl$\\ into File Explorer to browse your Linux file system straight from Windows. <\/p>\n\n\n\n
        Pro Tip<\/strong> 
        Create shortcuts to your most-used Linux directories in Windows File Explorer. Saves a ton of time.<\/em> <\/p>\n\n\n\n
        WSL2 Performance Optimization on Windows 11\u00a0<\/strong><\/h2>\n\n\n\n
        To squeeze better performance out of WSL2 on Windows 11, create or edit the .wslconfig file at %UserProfile%\\.wslconfig with resource limits: <\/p>\n\n\n\n
        [wsl2]\u00a0\nmemory=4GB\u00a0\nprocessors=2\u00a0\nswap=8GB\u00a0\nlocalhostForwarding=true\u00a0<\/code><\/pre>\n\n\n\n
         
        Tweak the memory and processors values based on your hardware. This stops WSL2 from eating too many system resources while keeping Linux operations fast. The localhostForwarding=true setting enables WSL2 mirrored networking Windows 11, which makes accessing services running inside Linux much simpler. <\/p>\n\n\n\n
        Configure Visual Studio Code with WSL2<\/strong><\/h2>\n\n\n\n
        Want to use Visual Studio Code directly from the WSL2 terminal for files inside the Linux file system? Install the VS Code WSL extension by running this inside your WSL2 session: <\/p>\n\n\n\n
        code .<\/code><\/pre>\n\n\n\n
         
        VS Code detects WSL2 automatically and prompts you to install the Remote – WSL extension if it’s missing. Once connected, you edit and debug Linux-side files with the full VS Code experience: IntelliSense, extensions, integrated terminal, everything. <\/p>\n\n\n\n
        Troubleshooting Common WSL2 Issues on Windows 11\u00a0<\/strong><\/h2>\n\n\n\n
        Hit a snag after installing WSL2? Try these fixes: <\/p>\n\n\n\n
        WSL2 Won’t Install or Enable<\/strong><\/h3>\n\n\n\n
        If the wsl –install command bombs, run sfc \/scannow in elevated PowerShell to fix corrupted system files. Also verify virtualization is turned on in your BIOS\/UEFI settings and the Virtual Machine Platform feature is enabled in Windows. The HCSEHYPERVNOTINSTALLED error on Windows 11 usually means virtualization is disabled in firmware. A quick BIOS toggle typically fixes it. <\/p>\n\n\n\n
        Linux Distribution Won’t Start\u00a0<\/strong><\/h3>\n\n\n\n
        When your Linux distribution refuses to start, the WSL service might be stuck. Run wsl –shutdown to kill all instances, wait 30 seconds, then launch your distro again. <\/p>\n\n\n\n
        Slow WSL2 Performance\u00a0<\/strong><\/h3>\n\n\n\n
        Poor performance often comes from over-allocated memory or too many processor cores. Check your .wslconfig settings and start with half your system’s RAM and no more than 75% of available cores. Keep project files inside the Linux file system (not on \/mnt\/) for the best disk I\/O speed. <\/p>\n\n\n\n
        WSL2 Network Problems\u00a0<\/strong><\/h3>\n\n\n\n
        Network issues in WSL2 usually clear up after resetting the network stack. Run wsl –shutdown, wait a minute, then restart your distribution to reinitialize the network configuration. <\/p>\n\n\n\n
        Advanced Tips for WSL2 Power Users\u00a0<\/strong><\/h2>\n\n\n\n
        GUI Application Support in WSL2\u00a0<\/strong><\/h3>\n\n\n\n
        WSL2 on Windows 11 supports Linux GUI applications natively through WSLg. Install your favorite graphical apps with apt and launch them directly. They show up as regular Windows windows next to your native apps, zero extra configuration needed. <\/p>\n\n\n\n
        Docker Desktop Integration with WSL2\u00a0<\/strong><\/h3>\n\n\n\n
        Install Docker Desktop and enable the WSL 2 backend to run containers seamlessly alongside your Windows 11 environment. Docker Desktop uses the WSL2 engine by default for way better performance than the old Hyper-V backend. <\/p>\n\n\n\n
        Development Environment Setup\u00a0<\/strong><\/h3>\n\n\n\n
        Build a complete development environment inside WSL2 by installing your language runtimes (Node.js, Python, Go), package managers, and version control tools. Pair this with VS Code’s Remote – WSL extension for a native-feeling development workflow entirely within the Linux file system. <\/p>\n\n\n\n
        Summary\u00a0<\/strong><\/h2>\n\n\n\n
        Installing WSL2 on Windows 11 gives you a powerful, flexible way to run Linux alongside Windows without compromising performance. In this guide we covered system requirements, the quick PowerShell installation method, picking a Linux distribution, essential management commands, file system integration, performance tuning, VS Code integration, and troubleshooting. <\/p>\n\n\n\n
        Whether you’re a developer, system administrator, or Linux enthusiast, WSL2 on Windows 11 provides the tools you need for efficient cross-platform work. Keep both your Windows system and WSL2 kernel updated for the latest features and security patches. Now get out there and build something in 2026. <\/p>\n\n\n\n
        WSL2 Frequently Asked Questions\u00a0<\/strong><\/h2>\n\n\n\n
        What Are the Minimum System Requirements to Install WSL2 on Windows 11?\u00a0<\/strong><\/strong> 
        To install WSL2 on Windows 11 you need a 64-bit processor with virtualization support (Intel VT-x or AMD-V), at least 4 GB of RAM (8 GB recommended), 5 GB of free disk space, and a fully updated Windows 11 installation. WSL2 requirements Windows 11 are identical across all editions.\u00a0<\/p> <\/div> 
        Does Windows 11 Home Support WSL2?\u00a0<\/strong><\/strong> 
        Yes, WSL2 Windows 11 Home support is complete. Unlike certain other virtualization features, WSL2 doesn’t require the Pro or Enterprise edition. The wsl –install command works the same across all Windows 11 editions.\u00a0<\/p> <\/div> 
        How Do I Install WSL2 Using PowerShell on Windows 11?\u00a0<\/strong><\/strong> 
        Open PowerShell as administrator and run wsl –install. This install WSL2 Windows 11 PowerShell command handles everything: enabling required Windows features, downloading the WSL2 kernel, and installing Ubuntu. Restart when prompted to finish the setup.\u00a0<\/p> <\/div> 
        How Do I Check If WSL2 Is Already Installed on My System?\u00a0<\/strong><\/strong> 
        Run wsl –list –verbose in PowerShell. If WSL2 is installed, you’ll see your distributions listed with their version number (1 or 2) and running state. If the command isn’t recognized, WSL is not yet installed on your system.\u00a0<\/p> <\/div> 
        What Should I Do If WSL2 Fails to Install or Enable?\u00a0<\/strong><\/strong> 
        Start by running sfc \/scannow in elevated PowerShell to repair corrupted system files. Then verify hardware virtualization is enabled in your BIOS\/UEFI and the Virtual Machine Platform feature is turned on in Windows. If you see HCSEHYPERVNOTINSTALLED, the BIOS setting is almost always the culprit.\u00a0<\/p> <\/div> <\/div>\n","protected":false},"excerpt":{"rendered":"
        Learn how to install WSL2 on Windows 11 with this step-by-step guide, covering system requirements, quick setup,  and more for the Windows Subsystem for Linux 2.<\/p>\n","protected":false},"author":50,"featured_media":21146,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"_uag_custom_page_level_css":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":"","_members_access_role":[],"_members_access_error":""},"categories":[18],"tags":[],"ppma_author":[1491],"class_list":["post-21028","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorials"],"uagb_featured_image_src":{"full":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2024\/11\/blog-head_how2-install-wsl2-on-windows-11.jpg",1200,630,false],"thumbnail":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2024\/11\/blog-head_how2-install-wsl2-on-windows-11-150x150.jpg",150,150,true],"medium":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2024\/11\/blog-head_how2-install-wsl2-on-windows-11-600x315.jpg",600,315,true],"medium_large":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2024\/11\/blog-head_how2-install-wsl2-on-windows-11-768x403.jpg",768,403,true],"large":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2024\/11\/blog-head_how2-install-wsl2-on-windows-11.jpg",1200,630,false],"1536x1536":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2024\/11\/blog-head_how2-install-wsl2-on-windows-11.jpg",1200,630,false],"2048x2048":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2024\/11\/blog-head_how2-install-wsl2-on-windows-11.jpg",1200,630,false]},"uagb_author_info":{"display_name":"Tobias Mildenberger","author_link":"https:\/\/contabo.com\/blog\/author\/tobias\/"},"uagb_comment_info":0,"uagb_excerpt":"Learn how to install WSL2 on Windows 11 with this step-by-step guide, covering system requirements, quick setup, and more for the Windows Subsystem for Linux 2.","authors":[{"term_id":1491,"user_id":50,"is_guest":0,"slug":"tobias","display_name":"Tobias Mildenberger","avatar_url":"https:\/\/secure.gravatar.com\/avatar\/077178d5dce6c3d4c0c0396857a7e544bfdf8adf04145fff5160b33a22e28b1f?s=96&d=mm&r=g","author_category":"","user_url":"https:\/\/contabo.com\/en\/","last_name":"Mildenberger","first_name":"Tobias","job_title":"","description":""}],"_links":{"self":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts\/21028","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/users\/50"}],"replies":[{"embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/comments?post=21028"}],"version-history":[{"count":3,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts\/21028\/revisions"}],"predecessor-version":[{"id":30765,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts\/21028\/revisions\/30765"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/media\/21146"}],"wp:attachment":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/media?parent=21028"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/categories?post=21028"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/tags?post=21028"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/ppma_author?post=21028"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}