Skip to content

Instantly share code, notes, and snippets.

Last active Dec 5, 2022
What would you like to do?
Install Void Linux on WSL2
# Based on
# prompt ">" indicates Powershell commands
> dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
> dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# install
> wsl --set-default-version 2
# use rootfs tarball from
# ex.:
# uncompress but do not unzip tar file
> wsl.exe --import $DISTRONAME $STORAGEPATH void-$VERSION.tar
> wsl -d $DISTRONAME
# optional - update xbps mirrors
$ cp /usr/share/xbps.d/*-repository-*.conf /etc/xbps.d/
# if in US
$ xbps-install -Su xbps
$ xbps-install -u
$ xbps-install base-system
$ xbps-remove base-voidstrap
$ xbps-reconfigure -fa
$ useradd -m -G wheel -s /bin/bash $USERNAME
$ passwd $USERNAME
$ su - $USERNAME
$ echo "[user]\ndefault=$USERNAME" > /etc/wsl.conf
# IMPORTANT - Use visudo to grant wheel group sudo (/etc/sudoers)
> wsl --terminate $DISTRONAME
> wsl -d $DISTRONAME
Copy link

jsumners commented Nov 11, 2022

This is fantastic stuff. Thank you for creating this document.

As of at least 2022-11-11, we don't need to use the final Powershell command to set the default user. Instead, we can:

$ echo -e "[user]\ndefault=$USERNAME" > /etc/wsl.conf
$ exit
> wsl --terminate $DISTRONAME
> wsl -d $DISTRONAME

See (

Also, for anyone else reading this, you may want to edit /etc/sudoers prior to exiting the initial root shell. Adjust it so that your newly added user can perform sudo actions.

One other tip: set your default distribution by wsl --setdefault $DISTRONAME.

Copy link

kmatt commented Nov 15, 2022

Simplified with suggestions from @jsumners

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment