WSL 2 Drive Mount

Mount a Linux disk in WSL 2  

Feedback

In this article

Show 4 more

If you want to access a Linux disk format that isn't supported by Windows, you can use WSL 2 to mount your disk and access its content. This tutorial will cover the steps to identify the disk and partition to attach to WSL2, how to mount them, and how to access them.

If you are connecting an external drive and do not have success with these mounting instructions, you may want to try the instructions to Connect USB devices. The wsl --mount command does not currently support USB/flash drives/SD card readers, (learn more about this issue).

 Note

Administrator access is required to attach a disk to WSL 2. The WSL 2 mount command does not support mounting a disk (or partitions that belong to the disk) that is currently in use. wsl --mount always attaches the entire disk even if only a partition is requested. You can't mount the Windows installation disk.

Prerequisites

You will need to be on Windows 11 Build 22000 or later, or be running the Microsoft Store version of WSL. To check your WSL and Windows version, use the command: wsl.exe --version

Differences between mounting an external drive with Windows formatting versus Linux formatting

External drives formatted for Windows typically use the NTFS file system formatting. External drives formatted for Linux typically use the Ext4 file system formatting.

If you have mounted an NTFS-formatted drive on your Windows file system, you can access that drive from your Linux distribution using WSL by creating a mounted directory (sudo mkdir /mnt/d, replacing 'd' with whatever drive letter you'd like to use) and then using the drvfs file system interop plugin, with the command:

Bash

Copy

sudo mount -t drvfs D: /mnt/d


Learn more about mounting scenarios.

If you have an Ext4-formatted drive, you cannot mount it on your Windows file system. In order to mount an Ext4-formatted drive on your Linux distribution with WSL, you can use the wsl --mount command following the instructions below.

Mounting an unpartitioned disk

If you have a disk that doesn't have any partitions, you can mount it directly using the wsl --mount command. First you need to identify the disk.

GET-CimInstance -query "SELECT * from Win32_DiskDrive"

wsl --mount <DiskPath>

Mounting a partitioned disk

If you have a disk that you aren't sure what file format it is in, or what partitions it has, you can follow the steps below to mount it.

GET-CimInstance -query "SELECT * from Win32_DiskDrive"

wsl --mount <DiskPath> --bare

lsblk

Inside Linux, a block device is identified as /dev/<Device><Partition>. For example, /dev/sdb3, is the partition number 3 of disk sdb.

Example output:

Bash

Copy

NAME   MAJ:MIN RM  SIZE RO TYPE MOUNTPOINT

sdb      8:16   0    1G  0 disk

├─sdb2   8:18   0   50M  0 part

├─sdb3   8:19   0  873M  0 part

└─sdb1   8:17   0  100M  0 part

sdc      8:32   0  256G  0 disk /

sda      8:0    0  256G  0 disk


Identifying the filesystem type

If you don't know the type of filesystem of a disk or partition, you can use this command:

Bash

Copy

blkid <BlockDevice>


This will output the detected filesystem type (under the TYPE="<Filesystem>" format).

Mount the selected partitions

Once you have identified the partitions you want to mount, run this command on each partition:

PowerShell

Copy

wsl --mount <DiskPath> --partition <PartitionNumber> --type <Filesystem>


 Note

If you wish to mount the entire disk as a single volume (i.e. if the disk isn't partitioned), --partition can be omitted.

If omitted, the default filesystem type is "ext4".

Access the disk content

Once mounted, the disk can be accessed under the path pointed to by the config value: automount.root. The default value is /mnt/wsl.

From Windows, the disk can be accessed from File Explorer by navigating to: \\wsl$\<Distro>\<Mountpoint> (pick any Linux distribution).

Unmount the disk

If you want to unmount and detach the disk from WSL 2, run:

PowerShell

Copy

wsl --unmount <DiskPath>


Mount a VHD in WSL

 Note

WSL from the Microsoft Store introduces a new argument to directly mount a VHD: wsl --mount --vhd <pathToVHD>

You can also mount virtual hard disk files (VHD) into WSL using wsl --mount. To do this, you first need to mount the VHD into Windows using the Mount-VHD command in Windows. Be sure to run this command with administrator privileges. Below is an example where we use this command, and also output the disk path. Be sure to replace <pathToVHD> with your actual VHD path.

PowerShell

Copy

Write-Output "\\.\PhysicalDrive$((Mount-VHD -Path <pathToVHD> -PassThru | Get-Disk).Number)"


You can use the output above to obtain the disk path for this VHD and mount that into WSL following the instructions in the previous section.

You can also use this technique to mount and interact with the virtual hard disks of other WSL distros, as each WSL 2 distro is stored via a virtual hard disk file called: ext4.vhdx. By default the VHDs for WSL 2 distros are stored in this path: C:\Users\[user]\AppData\Local\Packages\[distro]\LocalState\[distroPackageName], please exercise caution accessing these system files, this is a power user workflow. Make sure to run wsl --shutdown before interacting with this disk to ensure the disk is not in use.

Command line reference

Mounting a specific filesystem

By default, WSL 2 will attempt to mount the device as ext4. To specify another filesystem, run:

PowerShell

Copy

wsl --mount <DiskPath> -t <FileSystem>


For example, to mount a disk as fat, run:

Copy

wsl --mount <Diskpath> -t vfat


 Note

To list the available filesystems in WSL2, run: cat /proc/filesystems
When a disk has been mounted via WSL2 (Linux file system), it is no longer available to mount via an ext4 driver on the Windows file system.

Mounting a specific partition

By default, WSL 2 attempts to mount the entire disk. To mount a specific partition, run:

Copy

wsl --mount <Diskpath> -p <PartitionIndex>


This only works if the disk is either MBR (Master Boot Record) or GPT (GUID Partition Table). Read about partition styles - MBR and GPT.

Specifying mount options

To specify mount options, run:

PowerShell

Copy

wsl --mount <DiskPath> -o <MountOptions>


Example:

PowerShell

Copy

wsl --mount <DiskPath> -o "data=ordered"


 Note

Only filesystem specific options are supported at this time. Generic options such as ro, rw, noatime, ... are not supported.

Attaching the disk without mounting it

If the disk scheme isn't supported by any of the above options, you can attach the disk to WSL 2 without mounting it by running:

PowerShell

Copy

wsl --mount <DiskPath> --bare


This will make the block device available inside WSL 2 so it can be mounted manually from there. Use lsblk to list the available block devices inside WSL 2.

Specifying the mount name

 Note

This option is only available with WSL from the Microsoft Store

By default the mountpoint name is generated based on the physical disk or VHD name. This can be overridden with --name. Example:

PowerShell

Copy

wsl --mount <DiskPath> --name myDisk


Detaching a disk

To detach a disk from WSL 2, run:

PowerShell

Copy

wsl --unmount [DiskPath]


If Diskpath is omitted, all attached disks are unmounted and detached.

 Note

If one disk fails to unmount, WSL 2 can be forced to exit by running wsl --shutdown, which will detach the disk.

Limitations