home-manager/docs/release-notes/rl-2505.md

Release 25.05

The 25.05 release branch became stable in May, 2025.

Highlights

This release has the following notable changes:

• The option now defaults to true, meaning that services will automatically be restarted as needed when activating a configuration.

  Further, the "legacy" alternative has been removed and will now result in an evaluation error if used.

  The "suggest" alternative will remain for a while longer but may also be deprecated for removal in the future.

• The Home Manager test suite has been removed from the main Nix Flake since it caused unnecessary evaluations and downloads. Instead the tests are available through a Nix Flake file inside the tests directory. See for example commands.

State Version Changes

The state version in this release includes the changes below. These changes are only active if the home.stateVersion option is set to "25.05" or later.

• No changes.