Frequently Asked Questions


Windows on Raspberry imager

Why does the installation process keep failing?

Please check that:

  • you're using the latest version of WoR
  • your SD Card / USB drive are not failing (try with other hardware)
  • your anti-virus solution doesn't interfere with the deployment process (temporarily disable it)

If it fails at the Installing drivers stage, then there's probably an issue with the Windows installation on your PC. In this case, you can try to:

  • reinstall the operating system
  • run the WoR imager in a virtual machine, and passthrough the target drive
  • tell the tool to use a custom version of DISM.

If you want to do the latter, you'll first have to download and install a copy of the Windows ADK, then add the following path: adkInstallPath\Assessment and Deployment Kit\Deployment Tools\ARCH\DISM to the settings.ini file.

Replace adkInstallPath with the path where you've installed the ADK. (it's C:\Program Files (x86)\Windows Kits\10 by default)

Replace arch with the architecture of your machine (amd64, x86)

Why does the image installation process take a very long time?

Try temporarily disabling any anti-virus software. Windows Defender is known to slow down the process quite significantly. If this doesn't help, then the target drive may be too slow.

OK, but flashing Raspberry Pi OS or any other Linux distro is waaaaay faster. Are you really telling me that the drive is slow?

Sort of. Linux distros for Raspberry Pi usually come packaged in the .img format, which is a sector-by-sector copy of a disk drive. In other words, someone has shared an image of their SD card. (which, by the way, is an illegal thing to do for Windows, due to copyright reasons)

Now, why is this faster to install?

It's faster to install because an .img file is copied sequentially to your drive. Very cheap or old devices usually have decent sequential speed, but poor random I/O performance. The latter is what matters for Windows images, as they're file-based rather than sector-based.

Where can I report issues?

We have an issue tracker page just for that.

Make sure to attach the latest/relevant *.log file from the logs directory of WoR. (you can sort them by modified date in Explorer)

General

Does Windows 11 work?

For now, the insider builds do work. But this may change in the future.

While fTPM 2.0 and SecureBoot can be implemented in the UEFI, the Raspberry Pi doesn't meet the ARMv8.1 CPU requirement (it has ARMv8.0). That's not something a firmware update can fix, but we hope there'll be a way to bypass this requirement, if it gets enforced.

Where can I find Windows images?

See the Getting Windows Images guide.

I want to update a device driver without reinstalling Windows. What should I do?

We have a small tool for that purpose: Download here

You can also use DISM++.

Manual method:

  1. Mount the SD card on a Windows 10 desktop PC
  2. Launch Command Prompt as Administrator
  3. Type Dism /Image:WINLETTER: /Get-Drivers
  4. Choose the device driver that you want to update (e.g. OEM1.inf)
  5. Type Dism /Image:WINLETTER: /Remove-Driver /Driver:OEMx.inf
  6. After the driver has been removed, type Dism /Image:WINLETTER: /Add-Driver /Driver:PATHTOINF

WINLETTER = the Windows partition letter on your SD card (e.g. F)

OEMx.inf = the device driver that you want to remove, where x represents its number

PATHTOINF = path to the new driver (e.g. C:\WindowsPi\drivers\rpiuxflt\rpiuxflt.inf)

If you want to install a new device driver (not to update an existing one), you can follow the steps above but you don't have to remove any driver.

How can I access the boot partition (to edit config.txt or update the firmware)?

There's a tool that can help you do that: Boot partition mount utility

Why am I getting the 'Windows Setup could not configure...' error?

The "Windows Setup could not configure Windows to run on this computer's hardware." error usually occurs when the power was interrupted during the first boot process.

This can be fixed by re-installing the image.

Does the built-in Wi-Fi, Bluetooth, (insert device here) work?

You can find the current hardware support status here: https://github.com/worproject/RPi-Windows-Drivers#status

And no, we don't have an estimated time of arrival (ETA) for anything.

Why am I not able to use any USB devices?

Some outdated guides may tell you to use winpatch. This is no longer required and will break the USB driver.

I keep getting the 'Why did my PC restart?' screen. What should I do?

We don't currently know the exact cause of this issue, but we've seen it happen on slow SD cards / USB drives. So make sure to try a faster storage drive.

Note: sequential speeds don't matter as much as random I/O ones do.

Why drivers that work on my PC don't work on the Raspberry Pi?

Your PC most probably has an x86 Intel/AMD processor, while Raspberry Pi has a totally different CPU architecture.

Only ARM64 drivers are supported on Windows 10 ARM64.

We highly suggest asking the hardware vendor for ARM64 drivers. If enough people contact them, they may prioritize the request.

USB serial drivers?

There's a driver available for CP210x-based adapters: https://www.silabs.com/documents/public/software/CP210x_Universal_Windows_Driver.zip

Controllers that show up as a standard serial port, like Arduino boards with ATmega16u2, should work too.

You can also use the built-in serial pins on the GPIO header if you have the latest driver package installed.

USB Wi-Fi drivers?

Nope. There isn't a single adapter that's supported.

USB sound cards?

Yes. Most of them should work.

Devices that don't need 3rd party drivers are the most likely to work.

Can I run x86 / x64 apps?

Yes, you can run most x86 apps on Windows 10 ARM64.

x64 app support is currently available in the latest insider builds of Windows, and it's significantly faster than the x86 layer.

How can I see the CPU temperature and other hardware info?

Use the PiMon app from the Downloads page.

Why (insert application name here) doesn't work?

Some apps may not work as expected, and we can't really do anything about it. Please contact the app developer / hardware vendor for support.

Only 3 GB of RAM are available. How can I fix this?

  • keep pressing the ESC key after plugging in the power cord, until you see the UEFI setup screen.
  • go to Device Manager -> Raspberry Pi Configuration -> Advanced Configuration and change Limit RAM to 3 GB to Disabled.
  • press ESC several times to go back, then Y to save the settings when prompted and finally reboot the board.

How long does the first boot process take?

This mostly depends on the speed of your boot drive.

Something may have went wrong if:

  • 10 minutes have passed and you're not seeing the spinning dots
  • 1 hour has passed and you're still staring at the spinning dots

How long does the ISO download process take?

It depends on the speed of your internet connection, CPU and storage, thus we cannot tell you an average time.

The ISO download script has failed. What can I do?

In case this still doesn't solve the issue and you're not able to figure out the cause, UUPDump has a Discord server linked in the header of their website. People there may be able to help you.

You can also join the community servers for this project.

How can I delete the ISO download folder? It says that I don't have access.

This is a common issue with scripts from https://uup.rg-adguard.net. They fail / forget to unmount a WIM image.

To fix this, identify the stubborn mount folder, then execute the following command in a Command prompt window running as Administrator:

  • dism /unmount-image /mountdir:"YourStubbornMountDir" /discard

Can I use virtualization software? (Hyper-V, WSL2)

Not yet. While the CPU supports it, the UEFI doesn't properly inform the OS about this.

Enabling the Virtual Machine Platform will leave the system in an unbootable state!

How can I access the GPIO?

See:

How can I use the built-in PWM controller(s)?

See: https://github.com/raspberrypi/windows-drivers/tree/master/drivers/pwm/bcm2836#using-pwm-driver-from-kerneluser-mode

Can I use Windows Update?

See: How to perform OS updates

Does it work on the Compute Module (CM)?

It works on the Compute Module 3.

Compute Module 4 (with or without eMMC) is know to freeze at the UEFI boot screen. See: https://github.com/pftf/RPi4/issues/146

Even if you manage to get it booting on the CM4, USB support will require an 1 GB RAM limit. PCIe also won't work.

Will my case fan work?

If it needs any additional installation in Linux, then it will likely not work. The fan control services / scripts must be ported to Windows.

If it's a simple PWM fan, the UEFI can toggle it on boot. You just need to enable this functionality in the UEFI setup menu and connect the PWM signal pin accordingly.

How can I activate Windows?

With a regular license key.

Windows licenses are NOT architecture-specific, so you can use any key that you'd normally use on your PC.

Is this project legal?

See: https://www.raspberrypi.org/forums/viewtopic.php?p=1706253#p1706253 (some things in that post are outdated, like USB needing patches & such, but the legal aspect is still relevant today)

tl;dr: It's as legal as running Windows 10 on your PC.

We don't share any copyrighted files. You can generate Windows images from files publicly available on Microsoft servers.