Patch Notes

This release marks the introduction of release branches. Similar to how nixpkgs operates, there will now be a branch corresponding to each supported NixOS version going forward. The main branch has been updated to track nixos-unstable instead of the latest release.
The release channels should prevent NixOS WSL breaking on older NixOS versions because incompatible changes being introduced on the main branch.

Updating

NixOS 25.05 (recommended)

Because the main branch now tracks nixos-unstable, you will have to adjust the nixos-wsl channel in addition to the nixpkgs channel if you want to use a stable version of NixOS:

1. Set the new channel URLs

sudo nix-channel --add https://nixos.org/channels/nixos-25.05 nixos
sudo nix-channel --add https://github.com/nix-community/NixOS-WSL/archive/refs/heads/release-25.05.tar.gz nixos-wsl

1. Update the channels and rebuild your system configuration

sudo nix-channel --update
sudo nixos-rebuild switch

Flakes

If you're using flakes, adjust your inputs to use these URLs:

• nixpkgs:
  • github:NixOS/nixpkgs/nixos-25.05
• nixos-wsl
  • github:nix-community/nixos-wsl/release-25.05

After you've done that, run nix flake update and rebuild your system configuration

NixOS Unstable

If you want to use NixOS Unstable, you can keep using the main branch
Assuming that your channels/flake inputs already point to nixos-unstable and the main branch of this repo, you can just update and rebuild your system as usual.

Changelog

🛠️ General Changes

• drop systemd implementation from nixos-wsl-version (#733) @nzbr
• Add a logo (#643) @nzbr

🚀 Features

• merge /bin and /sbin (#666) @nzbr
• Allow setting wsl default user in the default nix config of the generated tarball (#653) @jbury
• wsl-distro: drop user-runtime-dir hack (#648) @K900

🪲 Bugfixes

• fix: usbip is missing cat and ls (#665) @nzbr
• fix: usbip doesn't work when enableStrictShellChecks is turned on (#707) @SuperSandro2000
• fix: rust warnings (#661) @Pvlerick
• fix: alter regex for wslConf.root to stop tripping up on darwin (#645) @isabelroses
• fix: update wsl.wslConf.automount.root regex to allow / (#636) @nzbr
• fix: WSL 2.5.1 (#641) @K900

🧪 Tests

• test(login-shell): fix home-manager URL (#696) @nzbr