diff --git a/index.html b/index.html index 7e5629de7..10a965536 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ -
ca.desrt.dconf
?+
ca.desrt.dconf
?This manual will eventually describe how to install, use, and extend Home Manager.
@@ -55,9 +55,11 @@ Manager generation: user environment.
If you do not plan on having Home Manager manage your shell configuration then you must source the -
$HOME/.nix-profile/etc/profile.d/hm-session-vars.sh
file in your shell configuration. Alternatively source
/etc/profiles/per-user/$USER/etc/profile.d/hm-session-vars.sh
when managing home configuration together with system configuration.
Unfortunately, we currently only support POSIX.2-like shells such as +
$HOME/.nix-profile/etc/profile.d/hm-session-vars.sh
file in your shell configuration. Alternatively source
/etc/profiles/per-user/$USER/etc/profile.d/hm-session-vars.sh
when managing home configuration together with system configuration.
This file can be sourced directly by POSIX.2-like shells such as Bash or -Z shell.
For example, if you use Bash then add
. "$HOME/.nix-profile/etc/profile.d/hm-session-vars.sh"
to your ~/.profile
file.
If instead of using channels you want to run Home Manager from a Git +Z shell.
For example, if you use Bash then add
. "$HOME/.nix-profile/etc/profile.d/hm-session-vars.sh"
to your ~/.profile
file. For fish shell, it is possible to use
+foreign-env to
+source the file.
If instead of using channels you want to run Home Manager from a Git
checkout of the repository then you can use the
programs.home-manager.path
option to specify the absolute path
to the repository.
Home Manager provides a NixOS module that allows you to prepare user @@ -281,7 +283,7 @@ building path(s) ‘/nix/store/b5c0asjz9f06l52l9812w6k39ifr49jj-user-environment Wide character in die at /nix/store/64jc9gd2rkbgdb4yjx3nrgc91bpjj5ky-buildenv.pl line 79. collision between ‘/nix/store/fmwa4axzghz11cnln5absh31nbhs9lq1-home-manager-path/bin/hello’ and ‘/nix/store/c2wyl8b9p4afivpcz8jplc9kis8rj36d-hello-2.10/bin/hello’; use ‘nix-env --set-flag priority NUMBER PKGNAME’ to change the priority of one of the conflicting packages builder for ‘/nix/store/b37x3s7pzxbasfqhaca5dqbf3pjjw0ip-user-environment.drv’ failed with exit code 2 -error: build of ‘/nix/store/b37x3s7pzxbasfqhaca5dqbf3pjjw0ip-user-environment.drv’ failed
The solution is typically to uninstall the package from the environment using nix-env --uninstall
and reattempt the Home Manager generation switch.
You could also opt to unistall all of the packages from your profile with nix-env --uninstall '*'
.
Home Manager is only able to set session variables automatically if it manages your Bash or Z shell configuration. If you don’t want to let Home Manager manage your shell then you will have to manually source the ~/.nix-profile/etc/profile.d/hm-session-vars.sh
file in an appropriate way. In Bash and Z shell this can be done by adding
. "$HOME/.nix-profile/etc/profile.d/hm-session-vars.sh"
to your .profile
and .zshrc
files, respectively. The hm-session-vars.sh
file should work in most Bourne-like shells.
A typical way to prepare a repository of configurations for multiple logins and machines is to prepare one "top-level" file for each unique combination.
For example, if you have two machines, called "kronos" and "rhea" on which you want to configure your user "jane" then you could create the files
The solution is typically to uninstall the package from the environment using nix-env --uninstall
and reattempt the Home Manager generation switch.
You could also opt to unistall all of the packages from your profile with nix-env --uninstall '*'
.
Home Manager is only able to set session variables automatically if it manages your Bash, Z shell, or fish shell configuration. If you don’t want to let Home Manager manage your shell then you will have to manually source the ~/.nix-profile/etc/profile.d/hm-session-vars.sh
file in an appropriate way. In Bash and Z shell this can be done by adding
. "$HOME/.nix-profile/etc/profile.d/hm-session-vars.sh"
to your .profile
and .zshrc
files, respectively. The hm-session-vars.sh
file should work in most Bourne-like shells. For fish shell, it is possible to source it using the foreign-env plugin
fenv source "$HOME/.nix-profile/etc/profile.d/hm-session-vars.sh" > /dev/null
A typical way to prepare a repository of configurations for multiple logins and machines is to prepare one "top-level" file for each unique combination.
For example, if you have two machines, called "kronos" and "rhea" on which you want to configure your user "jane" then you could create the files
kronos-jane.nix
,
rhea-jane.nix
, and
diff --git a/tools.html b/tools.html
index 88e72dde3..8670ac00e 100644
--- a/tools.html
+++ b/tools.html
@@ -1,6 +1,6 @@
-home-manager +
home-manager — reconfigure a user environment
home-manager
{
build
|
@@ -82,7 +82,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
.
@@ -151,7 +151,7 @@ available for immediate garbage collection.
-
The tool accepts the options
-A attrPath
@@ -259,15 +259,15 @@
--verbose
Activates verbose output. -