Fix WSL setup-flow accuracy (system requirements + installation) - #131
Merged
Merged
Conversation
- Drop the Hyper-V requirement; WSL 2 only needs Virtual Machine Platform + Windows Subsystem for Linux (Hyper-V isn't required and isn't even available on Windows Home). - State Windows 11 as the only supported minimum, dropping the stale Windows 10 1903/build 18362 branch. - Lead with `wsl --install --no-distribution` as the primary install path, keeping the manual OptionalFeatures/Store sequence as a documented fallback. - Fix the `wsl -v`/`wsl --version` decision branch: the legacy inbox WSL component errors on that flag rather than printing a "WSL version: 1.x.x.x" line, so the real branch is "not recognized -> install the modern version." - Fix absolute docs.dotkernel.org cross-links to relative paths. - Fix flattened em dash and stray period in installation.md, and correct the passwd success-message wording to match real output. - Add a systemd pre-flight check (and the `wsl --shutdown` requirement for /etc/wsl.conf changes to take effect) before continuing to Setup Packages, which depends on systemd being active.
arhimede
approved these changes
Sep 24, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
on Windows Home). Resolves Update README.md #3.
Windows 10 1903/build 18362 branch (confirmed the only Windows-version
mention anywhere in the repo). Resolves Create README.MD #4.
wsl --install --no-distributionas the primary install path,keeping the manual OptionalFeatures/Store sequence as a documented
fallback. Resolves Create README.MD #4.
wsl -v/wsl --versiondecision branch: the legacy inbox WSLcomponent errors on that flag rather than printing "WSL version:
1.x.x.x", so the real branch is "not recognized -> install the modern
version." Resolves create docker recipe #5.
docs.dotkernel.orgcross-links to relative paths.Resolves test slack integration #20 (partial).
stray period in the username example, and corrects the
passwdsuccess-message wording to match real output. Resolves git command for ignoring file permissions #22 (partial).
systemctl is-system-running) plus the[boot] systemd=true/wsl --shutdownfix, noting the same restart isneeded for the
[user] default=setting to take effect. Resolves WSL: Create Ansible playbook for AlmaLinux 8 #8.