{"id":1167,"date":"2026-11-18T22:22:16","date_gmt":"2026-11-18T22:22:16","guid":{"rendered":"https:\/\/windows-vps.org\/blog\/?p=1167"},"modified":"2026-11-18T22:22:16","modified_gmt":"2026-11-18T22:22:16","slug":"wsl2-on-windows-vps-hyperv-memory-requirement","status":"publish","type":"post","link":"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/","title":{"rendered":"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">WSL2 is not a compatibility layer like its predecessor. It runs a real Linux kernel inside a lightweight utility VM, which means it needs the Windows hypervisor \u2014 the same one Hyper-V uses. On a desktop that is usually free; on a Windows VPS it depends entirely on what your provider exposes. Half of all &#8220;WSL2 will not start on my VPS&#8221; cases come down to a missing virtualisation flag, and the other half to a memory reservation nobody accounted for.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This article covers the requirements, the exact error messages and their causes, how to cap WSL2&#8217;s memory footprint so it does not eat the host, and when the whole idea is a bad fit for a rented server. If you are choosing an instance for mixed Windows\/Linux development, <a href=\"https:\/\/windows-vps.org\/\">compare Windows VPS plans<\/a> with the numbers below in hand \u2014 WSL2 is memory-hungry in a way that is easy to underestimate.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">The Real Requirements<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">WSL2 requires Windows 10 version 2004 or later, Windows 11, or Windows Server 2019\/2022\/2025 with the <code>Microsoft-Windows-Subsystem-Linux<\/code> and <code>VirtualMachinePlatform<\/code> optional features enabled. Enable them with <code>Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux,VirtualMachinePlatform -All<\/code>, then reboot. On Server editions the Store is often absent, so use the MSI or <code>wsl --install --no-distribution<\/code> from a recent WSL release.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Underneath, WSL2 needs the Hyper-V hypervisor running at boot. On Windows Server that means installing the Hyper-V role (or merely enabling the hypervisor with <code>bcdedit \/set hypervisorlaunchtype auto<\/code>, which is what the VirtualMachinePlatform feature does). Check the current state with <code>bcdedit \/enum {current} | findstr hypervisorlaunchtype<\/code>. If it says <code>off<\/code>, WSL2 will refuse to start no matter how many times you reinstall the distro.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Critically, enabling the hypervisor changes the operating system&#8217;s relationship with the physical CPU. Windows itself becomes a guest of Hyper-V, and <code>systeminfo<\/code> will report &#8220;A hypervisor has been detected. Features required for Hyper-V will not be displayed.&#8221; That is expected \u2014 but it also means any other virtualisation software that needs raw VT-x (older VMware Workstation versions, VirtualBox pre-7, some Android emulators) will now fail or fall back to painfully slow emulation.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">When It Will Not Start: The Error Messages<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><code>WslRegisterDistribution failed with error: 0x80370102<\/code> \u2014 &#8220;The virtual machine could not be started because a required feature is not installed.&#8221; This is the nested-virtualisation error. The provider&#8217;s hypervisor is not exposing VT-x\/AMD-V to your guest. On KVM-based hosts this is the <code>nested=1<\/code> module option and a CPU model of <code>host-passthrough<\/code>; on Hyper-V parents it is <code>Set-VMProcessor -ExposeVirtualizationExtensions $true<\/code>. If you are on a fully virtualised container or a &#8220;VPS&#8221; that is really a slice of a shared kernel, it will never work.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>error: 0x80370114<\/code> \u2014 &#8220;The operation could not be started because a required feature is not installed.&#8221; Usually the hypervisor is not launching at boot (see <code>hypervisorlaunchtype<\/code>) or the VirtualMachinePlatform feature never finished installing. <code>0x8007019e<\/code> appears when the Windows Subsystem for Linux feature is off entirely, and <code>0x800701bc<\/code> means the WSL2 kernel update package is missing \u2014 install the <code>wsl_update_x64.msi<\/code> or run <code>wsl --update<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>WSL_E_VM_MODE_INVALID_STATE<\/code> or <code>Catastrophic failure<\/code> at distro launch typically indicates the utility VM is stuck. <code>wsl --shutdown<\/code> then restart; if it persists, <code>Get-Service LxssManager | Restart-Service<\/code>. For a stubborn case, <code>wsl --unregister &lt;distro&gt;<\/code> is destructive but decisive \u2014 export first with <code>wsl --export &lt;distro&gt; D:\\backup.tar<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Memory: The Default Is Greedy<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">By default WSL2 claims up to 50 percent of total host RAM for its utility VM, and it does not always give it back promptly. On an 8 GB VPS that means 4 GB you can no longer rely on for IIS, SQL Server Express or an RDS session \u2014 and the Windows kernel does not see it as available. When the host starts paging, everything slows down and the cause is invisible in Task Manager&#8217;s main view.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Cap it in <code>%UserProfile%\\.wslconfig<\/code>:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>[wsl2]\nmemory=3GB\nprocessors=2\nswap=2GB\nlocalhostForwarding=true<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Apply with <code>wsl --shutdown<\/code> and confirm inside the distro with <code>free -h<\/code> and <code>nproc<\/code>. A sensible rule for a shared VPS: leave at least 2 GB for the Windows side above what your Windows workloads need, and never allocate more than half of installed RAM to WSL. For a 4 GB instance running only developer tools, 2 GB in WSL is the ceiling before the host becomes unstable.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Swap is a separate file (<code>%LOCALAPPDATA%\\Temp\\swap.vhdx<\/code> by default) sitting on the system disk. On a VPS with modest storage this file grows silently. <code>Get-ChildItem -Recurse $env:LOCALAPPDATA\\Temp -Filter *.vhdx<\/code> shows the damage; keep swap small or set it to zero when the workload is bursty and stateless.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Disk, Filesystem and Cross-Boundary Performance<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Distros live in an ext4 VHDX under <code>%LOCALAPPDATA%\\Packages\\...\\LocalState<\/code>. Files accessed across the boundary \u2014 Windows paths mounted at <code>\/mnt\/c<\/code> \u2014 go through a 9P filesystem bridge and are dramatically slower than native ext4. Building a Node or .NET project with <code>node_modules<\/code> on <code>\/mnt\/c<\/code> can be five to ten times slower than the same project inside the Linux filesystem. Keep repositories in <code>~\/<\/code>, not on the Windows drive.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Growth is unbounded by default in recent WSL versions but older images are sparse files that never shrink. <code>wsl --manage &lt;distro&gt; --set-sparse true<\/code> helps; otherwise compact with <code>Optimize-VHD -Path &lt;vhdx&gt; -Mode Full<\/code> after a <code>wsl --shutdown<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Nested Hyper-V Inside WSL2<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Running Docker inside WSL2 works because Docker Desktop uses a separate hidden distro. Running full Hyper-V VMs inside WSL2 does not \u2014 WSL2&#8217;s kernel is a Microsoft-built kernel without the Hyper-V role, and nested virtualisation inside the utility VM is not supported. If you need containers, use Docker inside WSL; if you need Windows VMs, use the host&#8217;s Hyper-V role, which is already enabled.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">That is also why WSL2 and Hyper-V VMs compete for the same resource: both are guests of the same root hypervisor. A VPS running three Hyper-V test VMs and a WSL2 distro is really running four VMs&#8217; worth of memory pressure on one host. Plan the total, not the individual pieces.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">When a VPS Is the Wrong Place for WSL2<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If your provider does not expose nested virtualisation, no configuration will fix it, and a Linux VPS with SSH or a separate container host is the honest answer. If you only need a Linux shell for scripting or building a Go binary, the same result comes from a cheap Linux instance alongside the Windows one, without the hypervisor overhead.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Where WSL2 on a Windows VPS does earn its keep is a single-box development environment: Visual Studio on Windows, the build and test toolchain in Ubuntu, and no second machine to manage. For that, start from 8 GB RAM and 4 vCPU and set the <code>.wslconfig<\/code> cap before the first distro launch. <a href=\"https:\/\/windows-vps.org\/\">Our Windows VPS guides<\/a> cover provisioning choices; pick the instance with the memory headroom, because WSL2 will find every spare megabyte.<\/p>\n\n","protected":false},"excerpt":{"rendered":"<p>WSL2 is not a compatibility layer like its predecessor. It runs a real Linux kernel inside a lightweight utility VM, which means it needs the Windows hypervisor \u2014 the same one Hyper-V uses. On a desktop that is usually free; on a Windows VPS it depends entirely on what your provider exposes. Half of all &#8230; <a title=\"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start\" class=\"read-more\" href=\"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/\" aria-label=\"Read more about WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start\">Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":2,"footnotes":""},"categories":[5],"tags":[],"class_list":["post-1167","post","type-post","status-publish","format-standard","hentry","category-tutorials-guides"],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v26.1 (Yoast SEO v26.1) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start - Windows VPS Blog<\/title>\n<meta name=\"description\" content=\"WSL2 is not a compatibility layer like its predecessor. It runs a real Linux kernel inside a lightweight utility VM, which means it needs the Windows\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start\" \/>\n<meta property=\"og:description\" content=\"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start\" \/>\n<meta property=\"og:url\" content=\"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/\" \/>\n<meta property=\"og:site_name\" content=\"Windows VPS Blog\" \/>\n<meta property=\"article:published_time\" content=\"2026-11-18T22:22:16+00:00\" \/>\n<meta name=\"author\" content=\"windows-vps\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@myxiechengxuan\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"windows-vps\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/\",\"url\":\"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/\",\"name\":\"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start - Windows VPS Blog\",\"isPartOf\":{\"@id\":\"https:\/\/windows-vps.org\/blog\/#website\"},\"datePublished\":\"2026-11-18T22:22:16+00:00\",\"author\":{\"@id\":\"https:\/\/windows-vps.org\/blog\/#\/schema\/person\/44caceed916d0db318aa08d5623a7a58\"},\"description\":\"WSL2 is not a compatibility layer like its predecessor. It runs a real Linux kernel inside a lightweight utility VM, which means it needs the Windows\",\"breadcrumb\":{\"@id\":\"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/windows-vps.org\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/windows-vps.org\/blog\/#website\",\"url\":\"https:\/\/windows-vps.org\/blog\/\",\"name\":\"Windows VPS Blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/windows-vps.org\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/windows-vps.org\/blog\/#\/schema\/person\/44caceed916d0db318aa08d5623a7a58\",\"name\":\"windows-vps\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/windows-vps.org\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/3f2573db5afcd1a6ab9abcc5d48fc8e42584bc87ab9d98cc156e5b2097766dd9?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/3f2573db5afcd1a6ab9abcc5d48fc8e42584bc87ab9d98cc156e5b2097766dd9?s=96&d=mm&r=g\",\"caption\":\"windows-vps\"},\"sameAs\":[\"https:\/\/windows-vps.org\/blog\",\"https:\/\/x.com\/myxiechengxuan\"],\"url\":\"https:\/\/windows-vps.org\/blog\/author\/myxiechengxuan\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start - Windows VPS Blog","description":"WSL2 is not a compatibility layer like its predecessor. It runs a real Linux kernel inside a lightweight utility VM, which means it needs the Windows","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/","og_locale":"en_US","og_type":"article","og_title":"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start","og_description":"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start","og_url":"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/","og_site_name":"Windows VPS Blog","article_published_time":"2026-11-18T22:22:16+00:00","author":"windows-vps","twitter_card":"summary_large_image","twitter_creator":"@myxiechengxuan","twitter_misc":{"Written by":"windows-vps","Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/","url":"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/","name":"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start - Windows VPS Blog","isPartOf":{"@id":"https:\/\/windows-vps.org\/blog\/#website"},"datePublished":"2026-11-18T22:22:16+00:00","author":{"@id":"https:\/\/windows-vps.org\/blog\/#\/schema\/person\/44caceed916d0db318aa08d5623a7a58"},"description":"WSL2 is not a compatibility layer like its predecessor. It runs a real Linux kernel inside a lightweight utility VM, which means it needs the Windows","breadcrumb":{"@id":"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/windows-vps.org\/blog\/wsl2-on-windows-vps-hyperv-memory-requirement\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/windows-vps.org\/blog\/"},{"@type":"ListItem","position":2,"name":"WSL2 Nested on a Windows VPS: Hyper-V Requirement, Memory Reservation and When It Will Not Start"}]},{"@type":"WebSite","@id":"https:\/\/windows-vps.org\/blog\/#website","url":"https:\/\/windows-vps.org\/blog\/","name":"Windows VPS Blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/windows-vps.org\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/windows-vps.org\/blog\/#\/schema\/person\/44caceed916d0db318aa08d5623a7a58","name":"windows-vps","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/windows-vps.org\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/3f2573db5afcd1a6ab9abcc5d48fc8e42584bc87ab9d98cc156e5b2097766dd9?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/3f2573db5afcd1a6ab9abcc5d48fc8e42584bc87ab9d98cc156e5b2097766dd9?s=96&d=mm&r=g","caption":"windows-vps"},"sameAs":["https:\/\/windows-vps.org\/blog","https:\/\/x.com\/myxiechengxuan"],"url":"https:\/\/windows-vps.org\/blog\/author\/myxiechengxuan\/"}]}},"_links":{"self":[{"href":"https:\/\/windows-vps.org\/blog\/wp-json\/wp\/v2\/posts\/1167","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/windows-vps.org\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/windows-vps.org\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/windows-vps.org\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/windows-vps.org\/blog\/wp-json\/wp\/v2\/comments?post=1167"}],"version-history":[{"count":1,"href":"https:\/\/windows-vps.org\/blog\/wp-json\/wp\/v2\/posts\/1167\/revisions"}],"predecessor-version":[{"id":1172,"href":"https:\/\/windows-vps.org\/blog\/wp-json\/wp\/v2\/posts\/1167\/revisions\/1172"}],"wp:attachment":[{"href":"https:\/\/windows-vps.org\/blog\/wp-json\/wp\/v2\/media?parent=1167"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/windows-vps.org\/blog\/wp-json\/wp\/v2\/categories?post=1167"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/windows-vps.org\/blog\/wp-json\/wp\/v2\/tags?post=1167"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}