Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Build Installer Artifacts From WSL

Status: living

Use this when the Dubnium installer ISO and seed-model bundle should be prepared from an existing WSL distro.

This is only a build workflow. It is not .#wsl host activation and does not validate the WSL target.

Boundary

  • build the ISO and prepare the seed model here
  • write the USB with the platform’s guarded writer unless the USB disk is deliberately exposed to the WSL distro

Build

Enter the Nix-capable WSL distro:

wsl -d NixOS

Inside the distro:

cd /path/to/dubnium

git status --short
git -C external/dotfiles status --short

scripts/build-installer-iso.sh \
  --iso ./dubnium-installer.iso

The script prepares the current Dubnium default seed bundle when no existing materialized bundle is detected. Use --seed-model to point at a different bundle, --no-seed-download to require an existing bundle, or --no-seed-model to build installer-only media.

Write The USB

After the ISO exists in the shared checkout, use the platform writer from the custom installer runbook. For Windows PowerShell:

.\scripts\write-installer-usb.ps1 `
  -IsoPath .\dubnium-installer.iso `
  -DiskNumber 7 `
  -ExpectedFriendlyName "USB SanDisk 3.2Gen1" `
  -SeedModelPath ..\models\selected-model-bundle

Each writer still checks the USB disk identity and requires the typed erase confirmation.