From ac0a38c0f3c8684cc4338ab29baf90b6bb526e34 Mon Sep 17 00:00:00 2001
From: rycee
Add the appropriate Home Manager channel. If you are following Nixpkgs master or an unstable channel you can run
$ nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
$ nix-channel --update
-
and if you follow a Nixpkgs version 23.11 channel you can run
$ nix-channel --add https://github.com/nix-community/home-manager/archive/release-23.11.tar.gz home-manager
+
and if you follow a Nixpkgs version 24.05 channel you can run
$ nix-channel --add https://github.com/nix-community/home-manager/archive/release-24.05.tar.gz home-manager
$ nix-channel --update
Run the Home Manager installation command and create the first Home Manager generation:
$ nix-shell '<home-manager>' -A install
@@ -102,7 +102,7 @@ your system configuration. This is most conveniently done by adding a
Home Manager channel to the root user. For example, if you are following
Nixpkgs master or an unstable channel, you can run$ sudo nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
$ sudo nix-channel --update
-
and if you follow a Nixpkgs version 23.11 channel, you can run
$ sudo nix-channel --add https://github.com/nix-community/home-manager/archive/release-23.11.tar.gz home-manager
+
and if you follow a Nixpkgs version 24.05 channel, you can run
$ sudo nix-channel --add https://github.com/nix-community/home-manager/archive/release-24.05.tar.gz home-manager
$ sudo nix-channel --update
It is then possible to add
imports = [ <home-manager/nixos> ];
to your system configuration.nix
file, which will introduce a new
@@ -114,7 +114,7 @@ home-manager.users.eve = { pkgs, ... }: {
# The state version is required and should stay at the version you
# originally installed.
- home.stateVersion = "23.11";
+ home.stateVersion = "24.05";
};
and after a sudo nixos-rebuild switch
the user eve’s environment
should include a basic Bash configuration and the packages atool and
@@ -153,7 +153,7 @@ your system configuration. This is most conveniently done by adding a
Home Manager channel. For example, if you are following Nixpkgs master
or an unstable channel, you can run
$ nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
$ nix-channel --update
-
and if you follow a Nixpkgs version 23.11 channel, you can run
$ nix-channel --add https://github.com/nix-community/home-manager/archive/release-23.11.tar.gz home-manager
+
and if you follow a Nixpkgs version 24.05 channel, you can run
$ nix-channel --add https://github.com/nix-community/home-manager/archive/release-24.05.tar.gz home-manager
$ nix-channel --update
It is then possible to add
imports = [ <home-manager/nix-darwin> ];
to your nix-darwin configuration.nix
file, which will introduce a new
@@ -168,7 +168,7 @@ home-manager.users.eve = { pkgs, ... }: {
# The state version is required and should stay at the version you
# originally installed.
- home.stateVersion = "23.11";
+ home.stateVersion = "24.05";
};
and after a darwin-rebuild switch
the user eve’s environment should
include a basic Bash configuration and the packages atool and httpie.
If you do not plan on having Home Manager manage your shell @@ -240,7 +240,7 @@ command performs a combined build and activation.
{ config, pkgs, ... }:
# You can update Home Manager without changing this value. See
# the Home Manager release notes for a list of state version
# changes in each release.
- home.stateVersion = "23.11";
+ home.stateVersion = "24.05";
# Let Home Manager install and manage itself.
programs.home-manager.enable = true;
@@ -402,14 +402,14 @@ introduction about writing a Home Manager configuration.
init
command directly from its
flake.For example, if you are using the unstable version of Nixpkgs or NixOS, then to generate and activate a basic configuration run the command
$ nix run home-manager/master -- init --switch
-
For Nixpkgs or NixOS version 23.11 run
$ nix run home-manager/release-23.11 -- init --switch
+
For Nixpkgs or NixOS version 24.05 run
$ nix run home-manager/release-24.05 -- init --switch
This will generate a flake.nix
and a home.nix
file in
~/.config/home-manager
, creating the directory if it does not exist.
If you omit the --switch
option then the activation will not happen.
This is useful if you want to inspect and edit the configuration before
activating it.
$ nix run home-manager/$branch -- init
$ # Edit files in ~/.config/home-manager
$ nix run home-manager/$branch -- init --switch
-
Where $branch
is one of master
or release-23.11
.
After the initial activation has completed successfully then building +
Where $branch
is one of master
or release-24.05
.
After the initial activation has completed successfully then building and activating your flake-based configuration is as simple as
$ home-manager switch
It is possible to override the default configuration directory, if you want. For example,
$ nix run home-manager/$branch -- init --switch ~/hmconf
diff --git a/release-notes.xhtml b/release-notes.xhtml
index 3e2e8f80..65de9517 100644
--- a/release-notes.xhtml
+++ b/release-notes.xhtml
@@ -24,9 +24,15 @@
- Appendix D. Release Notes
Table of Contents
This section lists the release notes for stable versions of Home Manager
-and the current unstable version.
Release 24.05
Table of Contents
This is the current unstable branch and the information in this section
-is therefore not final.
Highlights
This release has the following notable changes:
The .release
file in the Home Manager project root has been
+
Appendix D. Release Notes
Table of Contents
This section lists the release notes for stable versions of Home Manager
+and the current unstable version.
Release 24.11
Table of Contents
This is the current unstable branch and the information in this section
+is therefore not final.
Highlights
This release has the following notable changes:
No changes.
+ 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
+"24.11" or later.
No changes.
+
+
+ Release 24.05
Table of Contents
The 24.05 release branch became stable in May, 2024.
Highlights
This release has the following notable changes:
The .release
file in the Home Manager project root has been
removed. Please use the release.json
file instead.
The home-manager uninstall command has been reworked to,
hopefully, be more robust. The new implementation makes use of a new
Boolean configuration option uninstall that can
@@ -68,7 +74,7 @@ use may in the future trigger a warning message and eventually it
may be removed entirely.
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
-"24.05" or later.
Nothing, yet.
+"24.05" or later.There was no state version change in this release.
Release 23.11
Table of Contents
The 23.11 release branch became stable in November, 2023.
Highlights
This release has the following notable changes:
When using programs.fish.enable, the setup code for