diff --git a/index.html b/index.html index 90dcf2db0..1bdfcf298 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.
@@ -245,7 +245,8 @@ The support is still experimental and may change in backwards incompatible ways.
Install Nix 2.4 or have it in nix-shell
.
Enable experimental features nix-command
and flakes
.
-
Either set in nix.conf
experimental-features = nix-command flakes
or pass them to nix
by
nix --experimental-features "nix-command flakes" your command
+
Either set in nix.conf
experimental-features = nix-command flakes
or pass them to nix
and home-manager
by
$ nix --extra-experimental-features "nix-command flakes" <sub-commands> +$ home-manager --extra-experimental-features "nix-command flakes" <sub-commands>
Prepare your Home Manager configuration (home.nix
).
Unlike the channel-based setup,
home.nix
will be evaluated when the flake is built,
@@ -296,12 +297,13 @@ The Home Manager library is exported by the flake under
Install Home Manager and apply the configuration by
$ nix build --no-link <flake-uri>#homeConfigurations.jdoe.activationPackage -$ "$(nix path-info <flake-uri>#homeConfigurations.jdoe.activationPackage)"/bin/activate
If flake.nix
resides in ~/.config/nixpkgs
,
+$ "$(nix path-info <flake-uri>#homeConfigurations.jdoe.activationPackage)"/bin/activate
Substitute <flake-uri>
with the flake URI of the configuration flake.
+If flake.nix
resides in ~/.config/nixpkgs
,
<flake-uri>
may be ~/.config/nixpkgs
as a Git tree or path:~/.config/nixpkgs
if not.
Since the release 21.05
,
building a flake-based configuration is as simple as
-
$ home-manager switch --flake 'flake-uri#jdoe'
once home-manager is installed.
Here, jdoe
is a configuration specified in the flake file,
+
$ home-manager switch --flake '<flake-uri>#jdoe'
once home-manager is installed.
Here, jdoe
is a configuration specified in the flake file,
and <flake-uri>#jdoe
will be expanded to
<flake-uri>#homeConfigurations.jdoe.activationPackage
and be built by Nix.
The flake inputs are not upgraded automatically when switching. diff --git a/tools.html b/tools.html index fb8810e1c..f5747218e 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. -