Adom Hydrogen

@@ -16,7 +16,7 @@ Each video was recorded on a test PC with the build named in its caption, sped u |---|---|---|---| | WSL2 installed from scratch | A PC that has never had WSL2: Hydrogen turns it on, asks for one restart, and finishes setup by itself afterwards | [video](wsl2-from-scratch.mp4) | `hd-vm-test.sh` (fresh snapshot) | | Mirrored networking: first install and an advanced user's own choice | Hydrogen connects the workspace to Windows without asking; a user who deliberately set NAT keeps it, and the Your AIs dialog explains what that costs | [video](mirrored-networking.mp4) | `scripts/test-scenarios/wslconfig-mirrored.sh` |-| WSL's firewall blocks the workspace | A security tool or policy blocked WSL's network; Hydrogen allows exactly outbound and loopback with one admin prompt and finishes | *video to come* (passes on every build since 1.0.545) | `scripts/test-scenarios/wsl-network-blocked.sh` |+| WSL's firewall blocks the workspace | A security tool or policy blocked WSL's network; Hydrogen allows exactly outbound and loopback with one admin prompt and finishes | [video](network-blocked.mp4) | `scripts/test-scenarios/wsl-network-blocked.sh` | | Windows 10 | The installer stops right away with a clear message, before installing anything | [video](windows10.mp4) | installer gate (manual run on an Azure Windows 10 VM) | | No hardware virtualization | A PC that cannot run WSL2: what it saw on 1.0.554 (installed WSL2, restarted, then hid the explanation behind other windows) and what 1.0.555 changes | [video](no-virtualization.mp4) | manual run on an Azure VM with the hypervisor off | | Not enough disk space | With 0.8 GB free the import filled the drive, setup sat silent for ten minutes, then asked for a Windows restart; 1.0.556 checks for 8 GB first | [video](disk-almost-full.mp4) | `scripts/test-scenarios/disk-almost-full.sh` |@@ -41,6 +41,10 @@ Each video was recorded on a test PC with the build named in its caption, sped u  *Mirrored networking, recorded on 1.0.552: first install turns it on with no question, the original setting is saved for uninstall, a user who sets NAT is respected, and the Your AIs dialog warns about AI sign-in. (On 1.0.554 and later the setup card no longer shows a warning at all; the Your AIs dialog is the only place it appears.)* +<video controls preload="metadata" width="1080" src="setup-steps-pitfalls/network-blocked.mp4" style="max-width:100%;height:auto"></video>++*WSL's firewall blocks the workspace, recorded on 1.0.554: Hydrogen finds outbound and loopback blocked, allows exactly those two with one admin prompt (this test PC has UAC off, so the prompt does not show), and setup finishes on its own.*+ ## The pitfalls, by setup phase  **Tested by** names the scenario script that reproduces it on a test PC. *Not yet* means it is documented here and handled in the code, but has no automated reproduction yet.@@ -100,7 +104,7 @@ Each video was recorded on a test PC with the build named in its caption, sped u |---|---|---|---| | WSL's default networking (NAT) | "Connecting your workspace to Windows" | Turns on mirrored networking, saves your original setting, and puts it back if you uninstall | `wslconfig-mirrored.sh` | | You deliberately set another networking mode | Nothing during setup; the Your AIs dialog warns that AI sign-in needs mirrored networking, with a button to turn it back on | Respects your choice and never changes it back on its own | `wslconfig-mirrored.sh` (adom/hydrogen#100) |-| A security tool or policy set WSL's firewall to block it | (was) setup stopped at "Building your workspace" | One WSL restart, then one admin prompt that allows exactly outbound traffic and loopback; inbound stays blocked | `wsl-network-blocked.sh` (adom/hydrogen#100) |+| A security tool or policy set WSL's firewall to block it | (was) setup stopped at "Building your workspace" | One WSL restart, then one admin prompt that allows exactly outbound traffic and loopback; inbound stays blocked | `wsl-network-blocked.sh` (adom/hydrogen#100), [video](network-blocked.mp4) | | The network comes back slowly after that fix | (was) "not confirmed", and Try again worked a minute later | Waits up to 90 seconds for the network, then carries on | `wsl-network-blocked.sh` | | Your organization's policy overrides the firewall | "A policy managed by your organization may be overriding it" | Says so and carries on | Not yet | | Windows too old for mirrored networking (before Windows 11 22H2) | The installer stops (see Windows 10 above) | Since 1.0.555 the installer's own minimum is 22H2, so setup never meets this | [video](windows10.mp4) |

⋯ 1 unchanged line ⋯