The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Windows Subsystem for Linux
Windows Subsystem for Linux
Introduction
Windows Subsystem for Linux provides support for running Funtoo Linux under Windows 10 and Windows 11. The latest version is WSL 2, which provides full system call compatibility, and improvement over the original WSL.
Requirements
To install WSL 2 on Windows, you need the following things:
- Windows 11 (any version, including Home), or:
- Windows 10 (any version, including Home) builds 18917 or higher
Technically you can install WSL 2 on an “insider” build of Windows 10 build 18917 or later.
Installation
To initially set up WSL 2, run a PowerShell prompt as an administrator and type:
root # wsl --install
After this command completes, and you reboot your system, it is then recommended to install Windows Terminal, which is available from this link -- this is actually a Microsoft Learn site describing Windows Terminal, but it does provide a link to the Microsoft Store page for Windows Terminal:
https://learn.microsoft.com/en-us/windows/terminal/
Start Windows Terminal. You can now use wget under PowerShell to download the stage3 of your choice:
root # wget -Uri https://build.funtoo.org/next/x86-64bit/amd64-zen3/2023-09-25/stage3-amd64-zen3-next-2023-09-25.tar.xz -OutFile stage3.tar.xz
Once the download completes, you will need to decompress it. This can be done by directly downloading the .exe for Windows, available from https://7-zip.org/a/7zr.exe, and running the following command:
root # .\Downloads\7zr.exe x stage3.tar.xz
- search for power shell, right click it's icon and select run as administrator:
root # wsl.exe --import "funtoo" "C:\funtoo" "C:\Users\$MYUSER\Downloads\gnome-stage3-amd64-piledriver-1.4-release-std-2020-12-16.tar" --version 2
root # wsl -d funtoo
you are now running funtoo under windows.
root # ego sync root # emerge -C debian-sources root # emerge -avuND @world
wsl behaves similar to a chroot instance regarding init.
root # mkdir /run/openrc root # touch /run/openrc/softlevel root # rc
- gwsl in the microsoft store can run graphical applications that are installed.
Xming uses ssh x11 forwarding to render x11 under windows:
bash_profile
instead of putting goodies to be executed at start in .bashrc, you should place them in .bash_profile
Bind USB to WSL
to attach usb devices to wsl you need to add usbipd.
root # emerge usbip
uninstall
- in powershell:
root # wsl.exe --unregister funtoo