Knowledge base
Install a Windows update offline with DISM
Use this route only when:
- Windows does not boot;
- package state and logs point to a cumulative update that did not complete;
- rollback does not restore a healthy previous state;
- the exact official package and any prerequisites are known.
Why use Windows PE?
Windows PE runs separately from the Windows installation on the SSD. DISM can therefore service that installation as an offline image.
dism /Image:D:\ ...
Do not use DISM /Online in Windows PE for the broken installation. /Online targets the running PE environment.
Prerequisites
Continue only if:
- data and recovery copies are protected;
- the SSD is reliable enough for writes;
- BitLocker can be unlocked;
- the actual Windows volume has been identified;
- Windows release and architecture are known;
- the exact Microsoft package and all prerequisites have been identified;
- enough free space is available for the package, logs and scratch files.
The examples use D: for Windows and E: for a writable recovery drive.
1. Identify Windows and check BitLocker
diskpart
list volume
exit
dir D:\Windows
dir D:\Program Files
dir D:\Users
manage-bde -status
Stop unless D: is clearly the intended, unlocked Windows installation.
2. Record the current state
dism /Image:D:\ /Get-CurrentEdition
mkdir E:\logs
dism /Image:D:\ /Get-Packages /Format:Table
dism /Image:D:\ /Get-Packages /Format:Table > E:\logs\packages-before.txt
Keep this output for comparison after the package operation.
3. Select the matching official package
Use Microsoft Update Catalog and the support page for the specific KB.
Check at least:
- Windows release, such as 24H2 or 25H2;
- x64 or Arm64;
- build family;
- exact KB number;
- publication date and package variant;
- required servicing or checkpoint packages.
From Windows 11 24H2 onwards, checkpoint cumulative updates can require earlier checkpoint MSUs. Follow the documentation for the specific KB.
4. Verify the downloaded file
If a trustworthy SHA-256 value is available:
Get-FileHash 'E:\packages\windows-update-x64.msu' -Algorithm SHA256
Do not use the file if the hash does not match. Also confirm that the package came from an official Microsoft source.
5. Create scratch space
mkdir E:\scratch
Make sure the location has enough free space.
6. Apply the verified package
dism /English /Image:D:\ /Add-Package /PackagePath:E:\packages\windows-update-x64.msu /ScratchDir:E:\scratch /LogPath:E:\logs\dism-add-package.log /LogLevel:4 /NoRestart
Expected: DISM accepts the package as applicable and completes the offline package operation without error.
If Microsoft documents prerequisites in a specific order, apply only those packages in that order.
7. Check package state and component-store health
dism /Image:D:\ /Get-Packages /Format:Table
dism /Image:D:\ /Get-Packages /Format:Table > E:\logs\packages-after.txt
dism /Image:D:\ /Cleanup-Image /ScanHealth /LogPath:E:\logs\dism-scanhealth-after.log
Compare packages-before.txt and packages-after.txt.
A targeted file check can be useful in a specific diagnosis:
sfc /verifyfile=D:\Windows\System32\winlogon.exe /offbootdir=D:\ /offwindir=D:\Windows
8. Let Windows finish configuring
A package added successfully offline may still configure during the next normal boot.
- do not interrupt a long first boot too quickly;
- allow for several automatic restarts;
- record a new stop code if startup still fails;
- test more than one successful boot.
After offline servicing, updated boot files may need to be copied to the system partition again:
Repair EFI and BCD with BCDBoot →
‘Package is not applicable’
Do not force the package. Recheck:
- Windows release and build;
- architecture;
- edition;
- packages already installed or superseded;
- required checkpoint or servicing packages.
Real-world example
On one Windows 11 PC, rollback did not restore a working installation. Package state and logs pointed to an update that had not completed locally.
The complete verified package could be applied offline. Windows then finished the remaining configuration during subsequent boots.
Stop if
- the package or prerequisites are not known exactly;
- BitLocker cannot be unlocked;
- the SSD is unreliable;
- there is not enough free space;
- DISM cannot open the image reliably.
Keep the logs and package lists for further diagnosis.