Skip to content


林博仁(Buo-ren Lin) edited this page Dec 12, 2018 · 8 revisions

The following are some known limitations of WoeUSB worth to be explicitly mentioned. Refer our issue tracker for other issues that you might encounter as well.

FAT32 Filesystem 4GiB Single File Size Limitation

In FAT32 filesystem, the file size is stored as a 32-bit integer value ranging from 0~4,294,967,295(4Gi-1) bytes, thus limiting the file to be smaller than approximatively 4GiB. As currently WoeUSB is only capable of creating FAT32 filesystem this causes source image with an install image(install.wim) greater than 4GiB unable to be copied to the target filesystem.

The solution is to use a target filesystem that supports bigger single file size limit and is also supported by Windows installer, which limits the choices to NTFS, exFAT, and other if any, while at the same time it is supported to be booted from legacy PC BIOS and UEFI.

Rufus's author has implemented a UEFI NTFS driver, and since WoeUSB v3.0.0 it is possible to use NTFS as the target filesystem by using the --target-filesystem command-line option:

woeusb \
    --target-filesystem NTFS \
    --device Win10_1809Oct_EnglishInternational_x64.iso /dev/sdX

Refer issue #144 for more info

Interpreter(bash) Support Limitations

WoeUSB requires several capabilities that are not available in the old versions of GNU Bash, refer the Compatibility page for more info.