NixOS on WSL(2) [maintainer=@nzbr]
  • Nix 61.3%
  • PowerShell 19.6%
  • Rust 19.1%
Find a file
renovate[bot] 379d20c55f
chore(deps): update rust crate anyhow to v1.0.102 (#985)
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2026-02-20 06:04:39 +01:00
.github chore(deps): update cachix/install-nix-action action to v31.9.1 (#982) 2026-02-20 05:34:50 +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 feat(options-doc): test doc generation for module 2026-02-08 15:53:35 +08:00
docs fix mdbook 2026-01-19 11:21:18 +01:00
modules fix(wsl/ssh-agent): use static type for users to fix documentation eval 2026-02-08 13:40:27 +08:00
tests feat: add --extra-files and --chown parameters (#752) 2025-11-12 01:25:14 +01:00
utils chore(deps): update rust crate anyhow to v1.0.102 (#985) 2026-02-20 06:04:39 +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 2026-02-07 20:40:37 +01:00
flake.nix feat(options-doc): test doc generation for module 2026-02-08 15:53:35 +08: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.