To make the NixOS module available for use you mu
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
to your system configuration.nix file, which will introduce a new
NixOS option called home-manager.users whose type is an attribute
set that maps user names to Home Manager configurations.
For example, a NixOS configuration may include the lines
To make the NixOS module available for use you must # 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 21.11 channel, you can run
to your nix-darwin configuration.nix file, which will introduce a
new NixOS option called home-manager whose type is an attribute set
that maps user names to Home Manager configurations.
For example, a nix-darwin configuration may include the lines
users.users.eve = {
@@ -283,7 +283,7 @@ Set up a flake with a flake.nix as follows:
# Update the state version as needed.
# See the changelog here:
# https://nix-community.github.io/home-manager/release-notes.html#sec-release-21.05
- stateVersion = "21.11";
+ stateVersion = "22.05";
# Optionally use extraSpecialArgs
# to pass through arguments to home.nix
@@ -292,9 +292,9 @@ Set up a flake with a flake.nix as follows:
}
Note
The above example tracks the master branch of Home Manager
and nixos-unstable branch of Nixpkgs.
-If you would like to use the release-21.11 branch,
-change the home-manager input url to github:nix-community/home-manager/release-21.11
-and nixpkgs url to github:NixOS/nixpkgs/nixos-21.11.
+If you would like to use the release-22.05 branch,
+change the home-manager input url to github:nix-community/home-manager/release-22.05
+and nixpkgs url to github:NixOS/nixpkgs/nixos-22.05.
Make sure to also update to the stateVersion option accordingly.
The Home Manager library is exported by the flake under
diff --git a/options.html b/options.html
index e6f00eacc..f55fc7566 100644
--- a/options.html
+++ b/options.html
@@ -1110,7 +1110,7 @@ settings are in effect and will therefore help avoid breaking
program configurations. Switching to a higher state version
typically requires performing some manual steps, such as data
conversion or moving files.
-
Type: one of "18.09", "19.03", "19.09", "20.03", "20.09", "21.03", "21.05", "21.11", "22.05"
"$USER" for state version < 20.09,
undefined for state version ≥ 20.09
diff --git a/release-notes.html b/release-notes.html
index 5c69d7d86..0258ba162 100644
--- a/release-notes.html
+++ b/release-notes.html
@@ -1,5 +1,10 @@
-Appendix E. Release Notes
This section lists the release notes for stable versions of Home Manager and the current unstable version.
E.1. Release 22.11
This is the current unstable branch and the information in this section is therefore not final.
E.1.1. Highlights
This release has the following notable changes:
+No changes.
+
E.1.2. 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 "22.11" or later.
+No changes.
+
E.2. Release 22.05
The 22.05 release branch became the stable branch in May, 2022.
E.2.1. Highlights
This release has the following notable changes:
The programs.waybar.settings.modules option was removed.
Waybar modules should now be declared directly under programs.waybar.settings.
@@ -11,12 +16,12 @@ such as the home-manager command line tool and the
then you can do so through the Home Manager Weblate project.
A new module, launchd.agents was added.
Use this to enable services based on macOS LaunchAgents.
-
E.1.2. State Version Changes
The state version in this release includes the changes below.
+
E.2.2. 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 "22.05" or later.
The programs.waybar.settings option now allows defining modules directly under programs.waybar.settings.
Defining modules under programs.waybar.settings.modules will now be an error.
For example,
-
The 21.11 release branch became the stable branch in November, 2021.
E.3.1. Highlights
This release has the following notable changes:
All Home Manager modules are now loaded on all platforms. With this
change you will get a more descriptive error message if you attempt to
enable a module that is incompatible with the host platform.
@@ -40,7 +45,7 @@ Rofi version 1.7.0 removed many options that were used by the module and replace
Taskwarrior version 2.6.0 respects XDG Specification for the config file now.
Option programs.taskwarrior.config and friends now generate the config file at
$XDG_CONFIG_HOME/task/taskrc instead of ~/.taskrc.
-
E.2.2. State Version Changes
The state version in this release includes the changes below. These
+
E.3.2. 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
"21.11" or later.
The home.keyboard option now defaults to null, meaning that Home Manager won’t do any keyboard layout management. For example, setxkbmap won’t be run in X sessions.
@@ -50,7 +55,7 @@ For example,
The 21.05 release branch became the stable branch in May, 2021.
E.4.1. Highlights
This release has the following notable changes:
The programs.broot.verbs option is now a list rather than an
attribute set. To migrate, move the keys of the attrset into the list
items' invocation keys. For example,
@@ -167,14 +172,14 @@ options in programs.htop. To migrate, set the htop
highlight_megabytes = 1;
highlight_threads = 1;
};
-};
E.3.2. State Version Changes
The state version in this release includes the changes below. These
+};
E.4.2. 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
"21.05" or later.
The newsboat module now stores generated configuration in
$XDG_CONFIG_HOME/newsboat.
-
E.4. Release 20.09
The 20.09 release branch became the stable branch in late September, 2020.
E.4.1. Highlights
This release has the following notable changes:
+
E.5. Release 20.09
The 20.09 release branch became the stable branch in late September, 2020.
E.5.1. Highlights
This release has the following notable changes:
Nothing has happened.
-
E.4.2. State Version Changes
The state version in this release includes the changes below. These
+
E.5.2. 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
"20.09" or later.
The options home.homeDirectory and home.username no
@@ -223,7 +228,7 @@ The options wayland.windowManager.sway.config.bars
binding_mode #2f343a #900000 #ffffff
}
-}
E.5. Release 20.03
The 20.03 release branch became the stable branch in April, 2020.
E.5.1. Highlights
This release has the following notable changes:
+}
E.6. Release 20.03
The 20.03 release branch became the stable branch in April, 2020.
E.6.1. Highlights
This release has the following notable changes:
Assigning a list to the home.file, xdg.configFile,
and xdg.dataFile options is now deprecated and will produce a
warning message if used. Specifically, if your configuration currently
@@ -279,7 +284,7 @@ configuration
user = "jd";
}
};
Support for the list form will be removed in Home Manager version
-20.09.
E.5.2. State Version Changes
The state version in this release includes the changes below. These
+20.09.
E.6.2. 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
"20.03" or later.
The 19.09 release branch became the stable branch in October, 2019.
E.6.1. Highlights
This release has the following notable changes:
+
E.7. Release 19.09
The 19.09 release branch became the stable branch in October, 2019.
E.7.1. Highlights
This release has the following notable changes:
The programs.firefox.enableGoogleTalk and
programs.firefox.enableIcedTea options are now deprecated
and will only work if Firefox ESR 52.x is used.
@@ -299,7 +304,7 @@ The programs.firefox.enableGoogleTalk and
The home-manager tool now provides an uninstall sub-command that
can be used to uninstall Home Manager, if used in the standalone
mode. That is, not as a NixOS module.
-
E.6.2. State Version Changes
The state version in this release includes the changes below. These
+
E.7.2. 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
"19.09" or later.
The 19.03 release branch became the stable branch in April, 2019.
E.7.1. Highlights
This release has the following notable changes:
+
E.8. Release 19.03
The 19.03 release branch became the stable branch in April, 2019.
E.8.1. Highlights
This release has the following notable changes:
The home.file.<name>.source option now allows source files to be
hidden, that is, having a name starting with the . character. It
also allows the source file name to contain characters not typically
@@ -325,10 +330,10 @@ encounter errors.
“defined multiple times” then you need to use the
mkForce
function. For example,
We had to make this change because the old merging was causing too
-many confusing situations for people.
E.7.2. State Version Changes
The state version in this release includes the changes below. These
+many confusing situations for people.
E.8.2. 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 “19.03” or later.
The 18.09 release branch became the stable branch in September, 2018.
\ No newline at end of file
+
E.9. Release 18.09
The 18.09 release branch became the stable branch in September, 2018.
\ No newline at end of file
diff --git a/tools.html b/tools.html
index 19407e7ce..a21a01702 100644
--- a/tools.html
+++ b/tools.html
@@ -1,6 +1,6 @@
-Appendix D. Tools
This command updates the user environment so that it corresponds to the
configuration specified in ~/.config/nixpkgs/home.nix or ~/.config/nixpkgs/flake.nix.
@@ -153,7 +153,7 @@
available for immediate garbage collection.
-
Options
+
Options
The tool accepts the options
-A attrPath
@@ -265,15 +265,15 @@
--verbose
Activates verbose output.
-
Files
+
Files
$XDG_DATA_HOME/home-manager/news-read-ids
Identifiers of news items that have been shown. Can be deleted to reset
the read news indicator.
-