Forum Discussion
Why My PC can't be upgraded to Windows 11 25H2?
How to solve the problem of "Can't upgrade to Windows 11 25H2"? Such as the "SetupDiag" compatibility shim bypass. This method uses a hidden compatibility troubleshooting tool from Microsoft to create a "shim" that tricks the installer.
1. Download the Official ISO:
Get the official Windows 11 25H2 ISO from Microsoft's website. Use the Media Creation Tool to extract it to a folder on your desktop (e.g., C:\Win11_25H2).
2. Download and Run SetupDiag:
- Go to the official SetupDiag GitHub page and download the latest version. It's a standalone tool from
- Microsoft used to diagnose why setup fails.
- Run SetupDiag.exe from a Command Prompt (as Administrator). By default, it will analyze previous setup logs. Let it run.
3. Create a Custom Configuration File:
- SetupDiag works by reading a rules file. We can create a custom one. In the same folder as
- SetupDiag.exe, create a new text file and name it SetupDiag.exe.config.
- Paste the following XML content into it. This creates a custom rule that always reports a "compatible" status.
xml
<?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <section name="SetupDiag" type="SetupDiag.SetupDiagSection, SetupDiag"/> </configSections> <SetupDiag> <Rules> <add name="ForceCompatCheckPass" type="SetupDiag.Rules.Bypass.CompatibilityBypass, SetupDiag" /> </Rules> </SetupDiag> </configuration>
4. Run the Upgrade from the Folder:
- Navigate to the C:\Win11_25H2 folder (or wherever you extracted the ISO).
- Right-click on setup.exe and select "Run as administrator".
- With SetupDiag and its custom config in the background, the Windows Setup process may inherit the "bypass" rule and skip the hardware compliance check, allowing the upgrade to proceed.