{"id":11477,"date":"2026-11-12T17:00:51","date_gmt":"2026-11-12T17:00:51","guid":{"rendered":"https:\/\/cheapwindowsvps.com\/blog\/how-to-shrink-wsl2-and-docker-desktop-vhdx-files-on-windows\/"},"modified":"2026-11-12T17:00:51","modified_gmt":"2026-11-12T17:00:51","slug":"how-to-shrink-wsl2-and-docker-desktop-vhdx-files-on-windows","status":"publish","type":"post","link":"http:\/\/cheapwindowsvps.com\/blog\/how-to-shrink-wsl2-and-docker-desktop-vhdx-files-on-windows\/","title":{"rendered":"How to Shrink WSL2 and Docker Desktop VHDX Files on Windows"},"content":{"rendered":"

WSL2 and Docker Desktop store their data in dynamically expanding VHDX files. These files grow as data is added, but deleting files inside Linux or Docker does not automatically reduce the space they occupy on the Windows drive.<\/p>\n

You can reclaim that space by cleaning up unused data and compacting the VHDX file.<\/p>\n

Compact a WSL2 virtual disk<\/h2>\n

First, check how much space is in use inside the Linux distribution:<\/p>\n

df -h \/<\/code><\/pre>\n
To find the distribution name, run this in Windows:<\/p>\n
wsl.exe --list --verbose<\/code><\/pre>\n
You can then locate its VHDX file using PowerShell. Replace Ubuntu-24.04<\/code> with your distribution\u2019s name:<\/p>\n
$wsl2distro = 'Ubuntu-24.04'$VHDX = (Get-ChildItem -Path HKCU:SoftwareMicrosoftWindowsCurrentVersionLxss |    Where-Object { $_.GetValue("DistributionName") -eq $wsl2distro }).GetValue("BasePath") + "ext4.vhdx"<\/code><\/pre>\n
Before compacting the disk, remove unnecessary files from the distribution. The ncdu<\/code> utility can help identify large files and directories:<\/p>\n
sudo apt-get install ncdusudo ncdu --exclude \/mnt<\/code><\/pre>\n
You can also remove unused packages and cached files on Ubuntu or Debian:<\/p>\n
sudo apt-get update && sudo apt-get autoremove -y && sudo apt-get clean<\/code><\/pre>\n
Shut down WSL before compacting the VHDX:<\/p>\n
wsl --shutdownwsl.exe --list --verbose<\/code><\/pre>\n
Make sure all distributions are stopped. Then use either Optimize-VHD<\/code> or DiskPart to compact the file.<\/p>\n
With Optimize-VHD<\/code>:<\/p>\n
Optimize-VHD -Path "C:pathtoext4.vhdx" -Mode Full<\/code><\/pre>\n
The Optimize-VHD<\/code> cmdlet requires the Hyper-V management tools, which are available on Windows Pro and Enterprise editions.<\/p>\n
Alternatively, use DiskPart:<\/p>\n
diskpartselect vdisk file="C:pathtoext4.vhdx"attach vdisk readonlycompact vdiskdetach vdiskexit<\/code><\/pre>\n
Afterward, check the VHDX file\u2019s size on the Windows drive. It should be closer to the amount of data actually stored in the Linux distribution. You can also move a WSL distribution to another drive<\/a> if you want to free space on the system volume.<\/p>\n
Reclaim Docker Desktop disk space<\/h2>\n
Docker Desktop also stores data in a WSL2 VHDX file. Check Docker\u2019s disk usage with:<\/p>\n
docker system df<\/code><\/pre>\n
Remove unused Docker images and other data first:<\/p>\n
docker system prune -a<\/code><\/pre>\n
Docker\u2019s WSL data is typically stored at:<\/p>\n
%LOCALAPPDATA%Dockerwsldiskdocker_data.vhdx<\/code><\/pre>\n
Close Docker Desktop, shut down WSL, then compact the file with one of the methods above. For example:<\/p>\n
wsl --shutdownOptimize-VHD -Path "$env:LOCALAPPDATADockerwsldiskdocker_data.vhdx" -Mode Full<\/code><\/pre>\n
Automatic space reclamation with sparse mode<\/h2>\n
WSL2 has an experimental sparse VHD feature that can return unused space to Windows as data is deleted. You can enable it for a distribution with:<\/p>\n
wsl --manage Ubuntu-24.04 --set-sparse true --allow-unsafe<\/code><\/pre>\n
The --allow-unsafe<\/code> option is required when WSL warns that sparse VHD support may cause data corruption. Because the feature is experimental and carries a risk to both the Windows NTFS volume and the guest ext4 filesystem, it is not recommended for production systems.<\/p>\n
You can also enable sparse mode in %UserProfile%.wslconfig<\/code>:<\/p>\n
[experimental]sparseVhd=true<\/code><\/pre>\n
Compact the VHDX with DiskPart or Optimize-VHD<\/code> before enabling sparse mode. Afterward, those tools can no longer be used to compact that file.<\/p>\n","protected":false},"excerpt":{"rendered":"
WSL2 and Docker Desktop store their data in dynamically expanding VHDX files. These files grow as data is added, but deleting files inside Linux or Docker does not\u2026<\/p>\n","protected":false},"author":0,"featured_media":11478,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[99],"tags":[],"class_list":["post-11477","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-windows-11"],"_links":{"self":[{"href":"http:\/\/cheapwindowsvps.com\/blog\/wp-json\/wp\/v2\/posts\/11477","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/cheapwindowsvps.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/cheapwindowsvps.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"http:\/\/cheapwindowsvps.com\/blog\/wp-json\/wp\/v2\/comments?post=11477"}],"version-history":[{"count":0,"href":"http:\/\/cheapwindowsvps.com\/blog\/wp-json\/wp\/v2\/posts\/11477\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"http:\/\/cheapwindowsvps.com\/blog\/wp-json\/wp\/v2\/media\/11478"}],"wp:attachment":[{"href":"http:\/\/cheapwindowsvps.com\/blog\/wp-json\/wp\/v2\/media?parent=11477"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/cheapwindowsvps.com\/blog\/wp-json\/wp\/v2\/categories?post=11477"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/cheapwindowsvps.com\/blog\/wp-json\/wp\/v2\/tags?post=11477"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}