WSL: Difference between revisions
imported>Tetov m Fix header hierarchy |
m Copyedits |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
Notes on running NixOS on the Windows Subsystem for Linux (WSL, WSL2) | Notes on running NixOS on the Windows Subsystem for Linux (WSL, WSL2). | ||
== Setup == | == Setup == | ||
Ensure that WSL is installed and up to date | Ensure that WSL is installed and up to date. | ||
<syntaxhighlight lang="powershell"> | <syntaxhighlight lang="powershell"> | ||
wsl --install | |||
wsl --update | wsl --update | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Sometimes you'll have to install WSL2 manually by [https://github.com/microsoft/WSL/releases downloading the msi-installation package]. | |||
NixOS is [https://github.com/microsoft/WSL/issues/11206 not yet packaged] as a official WSL distribution or on the Microsoft store. Download the latest release of <code>nixos-wsl.tar.gz</code> from the [https://github.com/nix-community/NixOS-WSL/releases NixOS-WSL Github page]. | NixOS is [https://github.com/microsoft/WSL/issues/11206 not yet packaged] as a official WSL distribution or on the Microsoft store. Download the latest release of <code>nixos-wsl.tar.gz</code> from the [https://github.com/nix-community/NixOS-WSL/releases NixOS-WSL Github page]. | ||
| Line 19: | Line 22: | ||
== Usage == | == Usage == | ||
Start it with | Start it with PowerShellː | ||
<syntaxhighlight lang="powershell"> | <syntaxhighlight lang="powershell"> | ||
| Line 29: | Line 32: | ||
=== Run container on startup === | === Run container on startup === | ||
To run the distro <code>NixOS</code> on Windows startup or user login in the background, | To run the distro <code>NixOS</code> on Windows startup or user login in the background, use these commands in PowerShellː | ||
<syntaxhighlight lang="powershell"> | <syntaxhighlight lang="powershell"> | ||
| Line 36: | Line 39: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Inside the script we define <code>NixOS</code> as the distribution name, as imported in the setup step above | Inside the script we define <code>NixOS</code> as the distribution name, as imported in the setup step above. | ||
{{file|$HOME\run_wsl2_at_startup.vbs|vbscript|<nowiki> | {{file|$HOME\run_wsl2_at_startup.vbs|vbscript|<nowiki> | ||
| Line 43: | Line 46: | ||
</nowiki>}} | </nowiki>}} | ||
Open the task schedulerː | |||
<syntaxhighlight lang="powershell"> | <syntaxhighlight lang="powershell"> | ||
| Line 49: | Line 52: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Click on <code>Create task</code> on the right pane, set name to <code>WSL</code>. On the tab "Triggers" click on "New ..." and select run task on user login in the dropdown menu. On the tab "Action" click on "New ..." and insert as command: <code>%USERPROFILE%\run_wsl2_at_startup.vbs</code> | Click on <code>Create task</code> on the right pane, set name to <code>WSL</code>. On the tab "Triggers" click on "New ..." and select "run task on user login" in the dropdown menu. On the tab "Action" click on "New ..." and insert as command: <code>%USERPROFILE%\run_wsl2_at_startup.vbs</code> | ||
[[Category:Container]] | |||