atlas-fleet/docs/SETUP.md

USB Kit Setup Guide

Vereisten

• Bootable Windows USB (gemaakt via Rufus of Media Creation Tool)
• HP EliteBook (of andere HP laptop met digitale Pro-licentie in BIOS)

Stap 1: Bestanden op USB zetten

Kopieer naar de root van de USB:

• autounattend.xml

Kopieer naar Scripts/ op de USB:

• Scripts/Setup-Laptop.ps1
• Scripts/fleet.config (hernoem van fleet.config.example, vul echte Tailscale key in)
• Scripts/HPImageAssistant.exe (download van hp.com/support als je HPIA wilt)

Stap 2: Boot van USB

1. HP: F9 voor boot menu
2. Kies de USB
3. Windows installeert volledig automatisch (geen klikken)

Stap 3: Setup-Laptop.ps1

Start automatisch na Windows-installatie:

1. Kies toetsenbord (AZERTY/QWERTY, 60s timeout = QWERTY)
2. WiFi verbinding (MET_Wifi / Metmet2021)
3. Windows Update inschakelen
4. HP Image Assistant: alle drivers installeren
5. Windows activering via BIOS digitale licentie
6. Computernaam instellen: ATLAS-[serienummer laatste 6 chars]
7. Tailscale enrollen + MeshCentral agent installeren
8. Administrator uitschakelen, opruimen, herstart

Debug: wat ging er fout?

Na een mislukte of geslaagde install staan logs op:

• C:\AtlasDebug\setup-phases.log — welke stap succesvol/mislukt
• C:\AtlasDebug\setup-transcript_*.txt — volledige console output
• C:\AtlasDebug\hardware-info.txt — BIOS model, serial, editie, activering
• C:\AtlasDebug\panther\*.log — Windows PE setup logs

Als USB aanwezig is bij einde setup: logs worden auto-gekopieerd naar E:\AtlasLogs.

Bekende bugs (opgelost in v2)

Bug	Symptoom	Oplossing
Core edition key op Pro BIOS	Setup crasht zonder foutmelding	Geen ProductKey in XML — BIOS bepaalt editie
Path-concatenatie fout in specialize	fleet.config niet gekopieerd	[IO.Path]::Combine() gebruikt
Geen logging	Bij crash weet je niks	Start-Transcript + hardware dump + USB export