ca.desrt.dconf or dconf.service?+
ca.desrt.dconf or dconf.service?This manual will eventually describe how to install, use, and extend Home Manager.
@@ -72,9 +72,9 @@ 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, 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 22.05 channel, you can run
# nix-channel --add https://github.com/nix-community/home-manager/archive/release-22.05.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
+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 22.05 channel, you can run
$ nix-channel --add https://github.com/nix-community/home-manager/archive/release-22.05.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, ... }: {
@@ -102,9 +102,9 @@ file, which often is more convenient than using the home-m
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, 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 22.05 channel, you can run
# nix-channel --add https://github.com/nix-community/home-manager/archive/release-22.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
+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 22.05 channel, you can run
$ nix-channel --add https://github.com/nix-community/home-manager/archive/release-22.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 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 = {
name = "eve";
@@ -577,8 +577,8 @@ in
];
# …
-}should work provided you have a Nix channel called nixpkgs-unstable.
You can add the nixpkgs-unstable channel by running
# nix-channel --add https://nixos.org/channels/nixpkgs-unstable nixpkgs-unstable
-# nix-channel --update
Note, the package will not be affected by any package overrides, overlays, etc.
By default Home Manager will install the package provided by your chosen nixpkgs channel but occasionally you might end up needing to change this package. This can typically be done in two ways.
+}
should work provided you have a Nix channel called nixpkgs-unstable.
You can add the nixpkgs-unstable channel by running
$ nix-channel --add https://nixos.org/channels/nixpkgs-unstable nixpkgs-unstable +$ nix-channel --update
Note, the package will not be affected by any package overrides, overlays, etc.
By default Home Manager will install the package provided by your chosen nixpkgs channel but occasionally you might end up needing to change this package. This can typically be done in two ways.
If the module provides a package option, such as programs.beets.package, then this is the recommended way to perform the override. For example,
programs.beets.package = pkgs.beets.override { enableCheck = true; };
If no package option is available then you can typically override the relevant package using an overlay.
diff --git a/tools.html b/tools.html
index dfc91abe1..7d1469810 100644
--- a/tools.html
+++ b/tools.html
@@ -1,6 +1,6 @@
-
home-manager +
home-manager — reconfigure a user environment
home-manager {
build
|
@@ -84,7 +84,7 @@
|
--verbose
}
- ]
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.
-
The tool accepts the options
-A attrPath
@@ -265,15 +265,15 @@
--verbose
Activates verbose output. -