ca.desrt.dconf?+
ca.desrt.dconf?This manual will eventually describes how to install, use, and extend Home Manager.
@@ -43,11 +43,12 @@ must be covered by the nix.allowedUsers system option.
-Add the Home Manager channel that you wish to follow. This is done -by running +Add the Home Manager channel that you wish to follow. If you are +following Nixpkgs master or an unstable channel then this is done by +running
$ nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager -$ nix-channel --update
if you are following Nixpkgs master or an unstable channel and
$ nix-channel --add https://github.com/nix-community/home-manager/archive/release-20.09.tar.gz home-manager -$ nix-channel --update
if you follow a Nixpkgs version 20.09 channel.
On NixOS you may need to log out and back in for the channel to become +$ nix-channel --update
and if you follow a Nixpkgs version 20.09 channel, you can run
$ nix-channel --add https://github.com/nix-community/home-manager/archive/release-20.09.tar.gz home-manager +$ nix-channel --update
On NixOS you may need to log out and back in for the channel to become available. On non-NixOS you may have to add
export NIX_PATH=$HOME/.nix-defexpr/channels${NIX_PATH:+:}$NIX_PATHto your shell (see nix#2033).
Run the Home Manager installation command and create the first Home @@ -69,9 +70,10 @@ up additional possibilities, for example, to automatically configure user environments in NixOS declarative containers or on systems deployed through NixOps.
To make the NixOS module available for use you must import it into
your system configuration. This is most conveniently done by adding a
-Home Manager channel, for example
# nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager -# nix-channel --update
if you are following Nixpkgs master or an unstable channel and
# nix-channel --add https://github.com/nix-community/home-manager/archive/release-20.09.tar.gz home-manager -# nix-channel --update
if you follow a Nixpkgs version 20.09 channel.
It is then possible to add
imports = [ <home-manager/nixos> ];
to your system configuration.nix file, which will introduce a new
+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 20.09 channel, you can run
# nix-channel --add https://github.com/nix-community/home-manager/archive/release-20.09.tar.gz home-manager +# nix-channel --update
It is then possible to add
imports = [ <home-manager/nixos> ];
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
users.users.eve.isNormalUser = true;
home-manager.users.eve = { pkgs, ... }: {
@@ -91,9 +93,10 @@ environments directly from the home-manager
tool.To make the NixOS module available for use you must import it into
your system configuration. This is most conveniently done by adding a
-Home Manager channel, for example
# nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
-# nix-channel --update
if you are following Nixpkgs master or an unstable channel and
# nix-channel --add https://github.com/nix-community/home-manager/archive/release-20.09.tar.gz home-manager
-# nix-channel --update
if you follow a Nixpkgs version 20.09 channel.
It is then possible to add
imports = [ <home-manager/nix-darwin> ];
to your nix-darwin configuration.nix file, which will introduce 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 20.09 channel, you can run
# nix-channel --add https://github.com/nix-community/home-manager/archive/release-20.09.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 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
home-manager.users.eve = { pkgs, ... }: {
home.packages = [ pkgs.atool pkgs.httpie ];
diff --git a/tools.html b/tools.html
index 3dc212de5..0e21293a9 100644
--- a/tools.html
+++ b/tools.html
@@ -1,6 +1,6 @@
-Appendix B. Tools - home-manager
- — reconfigure a user environment
Name
home-manager
+
Appendix B. Tools - home-manager
+ — reconfigure a user environment
Name
home-manager
— reconfigure a user environment
Synopsis
home-manager {
build
|
@@ -72,7 +72,7 @@
|
--verbose
}
- ]
Description
This command updates the user environment so that it corresponds to the
configuration specified in ~/.config/nixpkgs/home.nix.
@@ -137,7 +137,7 @@
available for immediate garbage collection.
-
Options
The tool accepts the options
-
-A attrPath
@@ -226,15 +226,15 @@
--verbose
Activates verbose output.
-