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.
@@ -13,7 +13,7 @@ be reported on the Home Manager issue tracker.
- Commands prefixed with # have to be run as root, either
+ Commands prefixed with $ sudo have to be run as root, either
requiring to login as root user or temporarily switching to it using
sudo for example.
Home Manager can be used in three primary ways:
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
+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 22.05 channel, you can run
$ sudo nix-channel --add https://github.com/nix-community/home-manager/archive/release-22.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
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, ... }: {
home.packages = [ pkgs.atool pkgs.httpie ];
programs.bash.enable = true;
-};and after a nixos-rebuild switch the user eve’s environment should
+};
and after a sudo nixos-rebuild switch the user eve’s environment should
include a basic Bash configuration and the packages atool and httpie.
If nixos-rebuild switch does not result in the environment you expect,
you can take a look at the output of the Home Manager activation script output using
$ systemctl status "home-manager-$USER.service"
If you do not plan on having Home Manager manage your shell configuration then you must add either
. "$HOME/.nix-profile/etc/profile.d/hm-session-vars.sh"
or
. "/etc/profiles/per-user/$USER/etc/profile.d/hm-session-vars.sh"
to your shell configuration, depending on whether diff --git a/tools.html b/tools.html index 1bda57917..901433367 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. -