> For the complete documentation index, see [llms.txt](https://www.osdeploy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.osdeploy.com/guide/basic/build-osdeployboot.md).
# Build a Boot Image
Build customized OSDeploy WinPE media from an imported WinRE image or the Windows ADK WinPE image.
Use `Build-OSDeployBoot` to customize a Windows Preinstallation Environment (WinPE) image, create bootable media and ISO files, and record the build configuration and logs under OSDeploy Core.
{% hint style="info" %}
OSDeploy creates and maintains the boot media on the workstation. OSDCloud runs from that media on the target device and performs the Windows deployment.
{% endhint %}
## Build the Boot Media
{% stepper %}
{% step %}
### Confirm the Requirements
Run the function on a workstation that meets these requirements:
* Windows 11 25H2 build 26200 or later
* PowerShell 7.6 or later installed from the MSI package
* Current [OSDeploy module](/guide/requirements/powershell-modules.md)
* Configured [OSDeploy Core](/guide/basic/update-osdeploycore.md)
* [Windows ADK and WinPE add-on](/guide/cmdlets/install-osdeploysoftware/windows-adk-25h2.md)
* OSDCloud module version `26.7.25.2` or later
* Administrator rights
* `curl.exe` available in `PATH`
{% hint style="warning" %}
The function stops before source selection when Windows, PowerShell, `curl.exe`, administrator access, OSDCloud, or Windows ADK requirements are not met. The Windows ADK is required even when the build source is an imported WinRE image.
{% endhint %}
{% endstep %}
{% step %}
### Run the Build
Open an elevated PowerShell 7.6 session and run:
```powershell
Build-OSDeployBoot
```
Select an imported WinRE image, shared content, and a wallpaper when prompted. The default workflow uses these settings:
| Setting | Default |
| --------------- | ------------------------------------------------------------- |
| Source image | Selected WinRE image, with Windows ADK WinPE fallback |
| Architecture | Selected WinRE architecture, or host architecture on fallback |
| Timezone | Current system timezone |
| ADK packages | Installed |
| USB update | Disabled |
| Existing folder | Add a numeric suffix instead of overwriting |
The function validates the environment, writes the configuration to `recent-amd64.json` or `recent-arm64.json`, prepares and mounts `boot.wim`, adds the selected packages and content, saves the image, and creates bootable media named `OSDeploy`. When compatible Secure Boot files exist in the selected WinRE source, it also creates CA 2023 media. ADK-sourced builds do not create the additional CA 2023 media.
{% endstep %}
{% endstepper %}
For source selection, profiles, customization, `WhatIf`, and advanced examples, see [Build-OSDeployBoot](/guide/cmdlets/build-osdeployboot.md). For compact syntax and parameter definitions, see the [Build-OSDeployBoot command reference](/command-reference/osdeploy/build-osdeployboot.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://www.osdeploy.com/guide/basic/build-osdeployboot.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
