First Complete Deployment

A step-by-step walkthrough to go from a fresh install to your first deployed machine.

1. Prepare the shares

Create and share the folders described in Installation, and copy at least one .wim image into \\SERVER\Images.

2. Initialize PSWinDeploy

pwsh -File .\Initialize-PSWinDeploy.ps1

Follow the interactive menu to configure PSWinDeploy.psd1 and create the secrets vault.

3. Build the WinPE image

Import-Module .\Modules\WinPE-Builder\WinPE-Builder.psm1
Build-WinPE -Architecture amd64 -OutputPath 'E:\PSWinDeploy\WinPE'

Burn the resulting ISO to a USB key, or publish it via PXE/WDS.

4. Create a profile and a sequence

Copy one of the sample files under Profiles/ and Sequences/, adjust the WIM image, domain OU, and default apps to match your environment.

5. Start the API

Install-Module Pode -Scope CurrentUser -Force
pwsh -File .\API\Deploy-API.ps1 -Port 8080

6. Start the web interface

cd Web
cp .env.example .env
# edit .env: VITE_API_URL=http://<windows-server>:8080
docker-compose up -d

Open http://<docker-host>:3000.

7. Deploy your first machine

1. In the web UI, pick your profile and select any optional apps.
2. Click Launch — this calls POST /api/deploy/prepare.
3. Boot the target machine on the WinPE media (USB or PXE).
4. Follow the disk/WIM selection assistant in Start-Deploy.ps1.
5. Let the sequence run through its reboots automatically.
6. Confirm you receive the mail/Teams notification at the end.