1
0
Fork 0
mirror of https://github.com/nix-community/home-manager.git synced 2025-11-08 11:36:05 +01:00
home-manager/docs/manual
Robert Helgesson de448dcb57
home-manager: avoid profile management during activation
This commit deprecates profile management from the activation script.
The profile management is instead the responsibility of the driving
software, for example, the `home-manager` tool in the case of
standalone installs.

The legacy behavior is still available for backwards compatibility but
may be removed in the future.

The new behavior resolves (or moves us closer to resolving) a number
of long standing open issues:

- `home-manager switch --rollback`, which performs a rollback to the
  previous Home Manager generation before activating. While it was
  previously possible to accomplish this by activating an old
  generation, it did always create a new profile generation.

  This option has been implemented as part of this commit.

- `home-manager switch --specialisation NAME`, which switches to the
  named specialisation. While it was previously possible to accomplish
  this by manually running the specialisation activate script, it did
  always create a new profile generation.

  This option has been implemented as part of this commit.

- `home-manager switch --test`, which activates the configuration but
  does not create a new profile generation.

  This option has _not_ been implemented here since it relies on the
  current configuration being activated on login, which we do not
  currently do.

- When using the "Home Manager as a NixOS module" installation method
  we previously created an odd `home-manager` per-user "shadow
  profile" for the user. This is no longer necessary.

  This has been implemented as part of this commit.

Fixes #3450
2025-07-22 11:00:18 +02:00
..
3rd-party docs: render without deprecated optionsDocBook 2023-12-07 21:27:38 +09:00
contributing docs: add note about importing modules (#7315) 2025-06-23 20:57:15 -05:00
faq docs: update beets and description of overriding packages 2024-03-14 21:20:04 +01:00
installation home-manager: set 25.05 as stable 2025-05-18 10:26:29 +02:00
internals home-manager: avoid profile management during activation 2025-07-22 11:00:18 +02:00
nix-flakes doc: fix instructions for enabling flakes in NixOS (#7189) 2025-06-03 07:57:46 -05:00
usage home-manager: avoid profile management during activation 2025-07-22 11:00:18 +02:00
writing-modules docs: render without deprecated optionsDocBook 2023-12-07 21:27:38 +09:00
3rd-party.md docs: render without deprecated optionsDocBook 2023-12-07 21:27:38 +09:00
contributing.md docs: render without deprecated optionsDocBook 2023-12-07 21:27:38 +09:00
faq.md docs: update beets and description of overriding packages 2024-03-14 21:20:04 +01:00
installation.md treewide: lnl7 -> nix-darwin 2025-05-16 18:47:17 -05:00
internals.md home-manager: avoid profile management during activation 2025-07-22 11:00:18 +02:00
introduction.md docs: introduction chapter 2024-06-26 23:48:52 +02:00
manpage-urls.json docs: render without deprecated optionsDocBook 2023-12-07 21:27:38 +09:00
manual.md home-manager: avoid profile management during activation 2025-07-22 11:00:18 +02:00
nix-darwin-options.md docs: render without deprecated optionsDocBook 2023-12-07 21:27:38 +09:00
nix-flakes.md flake-module: add flake-parts module (#5229) 2025-01-30 12:17:53 -06:00
nixos-options.md docs: render without deprecated optionsDocBook 2023-12-07 21:27:38 +09:00
options.md docs: render without deprecated optionsDocBook 2023-12-07 21:27:38 +09:00
preface.md docs: render without deprecated optionsDocBook 2023-12-07 21:27:38 +09:00
usage.md nixgl: API rework for flexibility and dual-GPU 2024-10-25 10:20:38 +02:00
writing-modules.md docs: render without deprecated optionsDocBook 2023-12-07 21:27:38 +09:00