NixOS on WSL(2) [maintainer=@nzbr]
Find a file
renovate[bot] be4af8042e
chore(deps): lock file maintenance (#937)
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2025-12-16 00:23:34 +01:00
.github Update renovate config (#788) 2025-12-15 22:09:14 +01:00
.vscode chore: fix vscode config 2024-05-13 16:59:28 +02:00
assets Add a logo (#643) 2025-03-17 12:03:08 +01:00
checks remove launcher code 2025-12-01 12:14:31 +01:00
docs Add hint to set password when using sudo with password to docs (#830) 2025-12-15 22:07:41 +01:00
modules use mkDefault for default uid (#943) 2025-12-15 21:32:47 +00:00
tests feat: add --extra-files and --chown parameters (#752) 2025-11-12 01:25:14 +01:00
utils chore(deps): lock file maintenance (#916) 2025-12-08 11:49:53 +01:00
.editorconfig Add DistroLauncher 2024-01-11 18:17:35 +01:00
.envrc add a module for docker-desktop support 2022-02-08 12:23:46 +01:00
.gitignore Distribute as .wsl file instead of .tar.gz (#600) 2025-02-14 14:05:56 +01:00
default.nix move build-tarball to a flake module 2022-02-01 04:01:13 +01:00
flake.lock chore(deps): lock file maintenance (#937) 2025-12-16 00:23:34 +01:00
flake.nix remove legacy and modern attributes 2025-12-01 12:16:51 +01:00
LICENSE Release under Apache 2 license 2021-01-17 23:10:48 +01:00
README.md Remove nixpkgs version shield 2025-08-12 14:52:03 +02:00
VERSION Rework version calculation code to support release-branches 2025-08-11 23:54:10 +02:00

NixOS-WSL
Matrix Chat Downloads

Modules for running NixOS on the Windows Subsystem for Linux

Documentation is available here

Quick Start

Run the following from powershell:

  1. Enable WSL if you haven't done already:
  • wsl --install --no-distribution
    
  1. Download nixos.wsl from the latest release.

  2. Double-click the file you just downloaded (requires WSL >= 2.4.4)

  3. You can now run NixOS:

  • wsl -d NixOS
    

For more detailed instructions, refer to the documentation.

License

Apache License, Version 2.0. See LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html for details.