NixOS on WSL [maintainer=@nzbr]
  • Nix 60.8%
  • PowerShell 20.5%
  • Rust 18.7%
Find a file
renovate[bot] d97e078f47
chore(deps): update cachix/install-nix-action action to v31.10.3 (main) (#1016)
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2026-03-31 15:59:12 +00:00
.github chore(deps): update cachix/install-nix-action action to v31.10.3 (main) (#1016) 2026-03-31 15:59:12 +00: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: proper check for setting /sbin when changing populateBin from true to false 2026-03-18 23:18:21 +01:00
tests add test for envfs 2026-03-18 23:18:21 +01:00
utils chore(deps): lock file maintenance 2026-03-15 20:42:57 +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-03-19 01:54:45 +01:00
flake.nix ci: add aarch64-linux support for checks, builds, and releases 2026-02-27 15:26:54 +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.