From ff48461cfd291d8371cc45f293d4f63dd9a76f42 Mon Sep 17 00:00:00 2001 From: Jonathan Holmgren Date: Fri, 27 May 2022 09:44:17 -0500 Subject: [PATCH] Updated Building PhoenixPE (markdown) --- Building-PhoenixPE.md | 25 ++++++++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/Building-PhoenixPE.md b/Building-PhoenixPE.md index 17a1123..f1db0ee 100644 --- a/Building-PhoenixPE.md +++ b/Building-PhoenixPE.md @@ -1,6 +1,8 @@ # Building PhoenixPE -1. Mount or Extract your Win10 ISO to a location of your choice. If you don’t have a Win10 ISO you may use the links on the 'Source Config' script to download the most recent version. +## Quick Start Guide + +1. Mount or Extract your Win10/Win11 ISO to a location of your choice. If you don’t have a Win10 ISO you may use the links on the 'Source Config' script to download the most recent version. Be sure to check the [Compatible Source List](https://github.com/PhoenixPE/PhoenixPE/wiki/Source-Compatibility) to make sure your ISO is supported. 1. Using the 'Source Config' script, select the location of your source you provided in Step 1. 1. Select the Source install.wim image. We recommend using the Pro image. 1. Enable the Apps you wish to include in your build. Note that some Apps require additional files or config. Do not blindly enable all apps and expect to get a successful build. @@ -10,3 +12,24 @@ 1. Test your finished build to make sure everything is working as you expect. 1. … 1. Profit! + +## Source Config + +### Configuring the Source Image + +PhoenixPE can be configured to build using either Boot.wim or WinRE.wim as a base. Each as advantages and disadvantages. + +#### Boot.wim #### + +Boot.wim is the image used by the Windows setup/installer and includes a basic WinPE environment. + +Because Boot.wim is designed to be a lightweight setup environment it does not contain integrated wireless networking or Windows recovery tools by default. PhoenixPE adds support for wireless networking, and other features by coping the required files and registry entries from install.wim; the same method used by legacy projects such as VistaPE, Win7PE, and Win10PE. This method produces an environment very similar to WinRE. + +#### WinRE.wim (Default) #### + +WinRE.wim is the Windows Recovery Environment that ships with Windows and is used for diagnostic and troubleshooting. It includes additional packages such as integrated wireless networking support, and the Windows recovery tools. + +Beginning with Windows release 20H2, WinRE.wim is not always updated to the latest version and contains binaries and registry entries that are incompatible with the newer binaries present in install.wim. This can cause stability issues or in worst case, BSOD, black screen on boot, etc. In these situations you must build the project using Boot.wim as the base image. + +## Advanced Options +