WSL - Revision history

Phobos: Updated intructions

2026-03-10T20:42:31Z

Updated intructions

← Older revision		Revision as of 20:42, 10 March 2026
Line 12:		Line 12:
	Sometimes you'll have to install WSL2 manually by [https://github.com/microsoft/WSL/releases downloading the msi-installation package].		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</code> from the [https://github.com/nix-community/NixOS-WSL/releases NixOS-WSL Github page].

	~~Import~~ the WSL ~~container using PowerShell~~		Double-click the file you just downloaded (requires WSL >= 2.4.4).

	~~<syntaxhighlight lang~~=~~"powershell">~~
	~~wsl --import NixOS~~ .~~\NixOS\ nixos-wsl~~.~~tar~~.~~gz --version 2~~
	~~</syntaxhighlight>~~

	== Usage ==		== Usage ==

Ponder: Copyedits

2025-08-08T10:22:36Z

Copyedits

← Older revision		Revision as of 10:22, 8 August 2025
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 ==
Line 22:		Line 22:
	== Usage ==		== Usage ==

	Start it with ~~PowerShell~~		Start it with PowerShellː

	<syntaxhighlight lang="powershell">		<syntaxhighlight lang="powershell">
Line 32:		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, ~~proceed with following~~ commands in ~~PowerShell~~		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 39:		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 46:		Line 46:
	</nowiki>}}		</nowiki>}}

	~~Execute following command to open~~ the task ~~planer~~		Open the task schedulerː

	<syntaxhighlight lang="powershell">		<syntaxhighlight lang="powershell">
Line 52:		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]]		[[Category:Container]]

Klinger: Category:Container

2024-04-24T20:36:18Z

Category:Container

← Older revision		Revision as of 20:36, 24 April 2024
Line 53:		Line 53:

	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]]

Onny: Further details on WSL2 installation

2024-04-17T10:17:55Z

Further details on WSL2 installation

← Older revision		Revision as of 10:17, 17 April 2024
Line 3:		Line 3:
	== 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].

imported>Tetov: Fix header hierarchy

2024-03-11T12:00:55Z

Fix header hierarchy

← Older revision		Revision as of 12:00, 11 March 2024
Line 27:		Line 27:
	== Tips and tricks ==		== Tips and tricks ==

	== Run container on startup ==		=== Run container on startup ===

	To run the distro <code>NixOS</code> on Windows startup or user login in the background, proceed with following commands in PowerShell		To run the distro <code>NixOS</code> on Windows startup or user login in the background, proceed with following commands in PowerShell

imported>Tetov: Clarification on task scheduling and corrected language parameters for pre/file

2024-03-11T12:00:05Z

Clarification on task scheduling and corrected language parameters for pre/file

← Older revision		Revision as of 12:00, 11 March 2024
Line 5:		Line 5:
	Ensure that WSL is installed and up to date		Ensure that WSL is installed and up to date

	<syntaxhighlight lang="~~bash~~">		<syntaxhighlight lang="powershell">
	wsl --update		wsl --update
	</syntaxhighlight>		</syntaxhighlight>
Line 13:		Line 13:
	Import the WSL container using PowerShell		Import the WSL container using PowerShell

	<syntaxhighlight lang="~~bash~~">		<syntaxhighlight lang="powershell">
	wsl --import NixOS .\NixOS\ nixos-wsl.tar.gz --version 2		wsl --import NixOS .\NixOS\ nixos-wsl.tar.gz --version 2
	</syntaxhighlight>		</syntaxhighlight>
Line 21:		Line 21:
	Start it with PowerShell		Start it with PowerShell

	<syntaxhighlight lang="~~bash~~">		<syntaxhighlight lang="powershell">
	wsl -d NixOS		wsl -d NixOS
	</syntaxhighlight>		</syntaxhighlight>
Line 31:		Line 31:
	To run the distro <code>NixOS</code> on Windows startup or user login in the background, proceed with following commands in PowerShell		To run the distro <code>NixOS</code> on Windows startup or user login in the background, proceed with following commands in PowerShell

	<syntaxhighlight lang="~~bash~~">		<syntaxhighlight lang="powershell">
	echo "" > $HOME\run_wsl2_at_startup.vbs		echo "" > $HOME\run_wsl2_at_startup.vbs
	notepad $HOME\run_wsl2_at_startup.vbs		notepad $HOME\run_wsl2_at_startup.vbs
Line 38:		Line 38:
	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\|~~vbs~~\|<nowiki>		{{file\|$HOME\run_wsl2_at_startup.vbs\|vbscript\|<nowiki>
	set object = createobject("wscript.shell")		set object = createobject("wscript.shell")
	object.run "wsl.exe --distribution NixOS", 0		object.run "wsl.exe --distribution NixOS", 0
Line 45:		Line 45:
	Execute following command to open the task planer		Execute following command to open the task planer

	<syntaxhighlight lang="~~bash~~">		<syntaxhighlight lang="powershell">
	taskschd.msc		taskschd.msc
	</syntaxhighlight>		</syntaxhighlight>

	Click on <code>~~New~~ 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. 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>

imported>Onny: Note that NixOS is not yet officially packaged on MS store

2024-02-24T17:07:37Z

Note that NixOS is not yet officially packaged on MS store

← Older revision		Revision as of 17:07, 24 February 2024
Line 9:		Line 9:
	</syntaxhighlight>		</syntaxhighlight>

	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].

	Import the WSL container using PowerShell		Import the WSL container using PowerShell

imported>Onny: Run container on startup

2024-01-24T14:31:31Z

Run container on startup

← Older revision		Revision as of 14:31, 24 January 2024
Line 24:		Line 24:
	wsl -d NixOS		wsl -d NixOS
	</syntaxhighlight>		</syntaxhighlight>

			== Tips and tricks ==

			== Run container on startup ==

			To run the distro <code>NixOS</code> on Windows startup or user login in the background, proceed with following commands in PowerShell

			<syntaxhighlight lang="bash">
			echo "" > $HOME\run_wsl2_at_startup.vbs
			notepad $HOME\run_wsl2_at_startup.vbs
			</syntaxhighlight>

			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\|vbs\|<nowiki>
			set object = createobject("wscript.shell")
			object.run "wsl.exe --distribution NixOS", 0
			</nowiki>}}

			Execute following command to open the task planer

			<syntaxhighlight lang="bash">
			taskschd.msc
			</syntaxhighlight>

			Click on <code>New 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. On the tab "Action" click on "New ..." and insert as command: <code>%USERPROFILE%\run_wsl2_at_startup.vbs</code>

imported>Onny: Add note on update WSL

2024-01-24T14:06:20Z

Add note on update WSL

← Older revision		Revision as of 14:06, 24 January 2024
Line 2:		Line 2:

	== Setup ==		== Setup ==

			Ensure that WSL is installed and up to date

			<syntaxhighlight lang="bash">
			wsl --update
			</syntaxhighlight>

	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].		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].

imported>Onny: Restructuring page

2024-01-24T13:26:27Z

Restructuring page

← Older revision		Revision as of 13:26, 24 January 2024
Line 11:		Line 11:
	</syntaxhighlight>		</syntaxhighlight>

	Start it		== Usage ==

			Start it with PowerShell

	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	wsl -d NixOS		wsl -d NixOS
	</syntaxhighlight>		</syntaxhighlight>