diff --git a/index.xhtml b/index.xhtml index 4bbebbc28..9709fbbfe 100644 --- a/index.xhtml +++ b/index.xhtml @@ -9,7 +9,7 @@ - +
-

Table of Contents

Preface
Installing Home Manager
Standalone installation
NixOS module
nix-darwin module
Using Home Manager
Configuration Example
Rollbacks
Keeping your ~ safe from harm
Graphical services
Updating
Nix Flakes
Prerequisites
Standalone setup
NixOS module
nix-darwin module
Writing Home Manager Modules
Option Types
Contributing
Getting started
Guidelines
News
Tests
Third-Party Tools and Extensions
Module Collections
Frequently Asked Questions (FAQ)
Why is there a collision error when switching generation?
Why are the session variables not set?
How to set up a configuration for multiple users/machines?
Why do I get an error message about ca.desrt.dconf or dconf.service?
How do I install packages from Nixpkgs unstable?
How do I override the package used by a module?
A. Home Manager Configuration Options
B. NixOS Configuration Options
C. nix-darwin Configuration Options
+

Table of Contents

Preface
Installing Home Manager
Standalone installation
NixOS module
nix-darwin module
Using Home Manager
Configuration Example
Rollbacks
Keeping your ~ safe from harm
Graphical services
Updating
Nix Flakes
Prerequisites
Standalone setup
NixOS module
nix-darwin module
Writing Home Manager Modules
Option Types
Contributing
Getting started
Guidelines
News
Tests
Third-Party Tools and Extensions
Module Collections
Frequently Asked Questions (FAQ)
Why is there a collision error when switching generation?
Why are the session variables not set?
How to set up a configuration for multiple users/machines?
Why do I get an error message about ca.desrt.dconf or dconf.service?
How do I install packages from Nixpkgs unstable?
How do I override the package used by a module?
A. Home Manager Configuration Options
B. NixOS Configuration Options
C. nix-darwin Configuration Options
D. Release Notes

Preface

This manual will eventually describe how to install, use, and extend Home Manager.

If you encounter problems then please reach out on the IRC channel #home-manager @@ -89,7 +89,7 @@ users can use utilities such as babelfish.

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 checkout of the repository then you can use the -home-manager.path option to specify the absolute +home-manager.path option to specify the absolute path to the repository.

Once installed you can see Using Home Manager for a more detailed description of Home Manager and how to use it.

NixOS module

Home Manager provides a NixOS module that allows you to prepare user @@ -125,7 +125,7 @@ output using

$ systemctl status &quo
 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 -home-manager.useUserPackages is enabled. This file can +home-manager.useUserPackages is enabled. This file can be sourced directly by POSIX.2-like shells such as Bash or Z shell. Fish users @@ -175,7 +175,7 @@ include a basic Bash configuration and the packages atool and httpie.

If y 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 -home-manager.useUserPackages is enabled. This +home-manager.useUserPackages is enabled. This file can be sourced directly by POSIX.2-like shells such as Bash or Z shell. Fish users @@ -216,10 +216,10 @@ error: A definition for option `programs.emacs.enable' is not of type `bool

The message indicates that you must provide a Boolean value for this option, that is, either true or false. The documentation of each option will state the expected type, for -programs.emacs.enable you will see “Type: boolean”. You +programs.emacs.enable you will see “Type: boolean”. You there also find information about the default value and a description of the option. You can find the complete option documentation in -Home Manager Configuration Options or directly in the terminal by running

man home-configuration.nix
+Home Manager Configuration Options or directly in the terminal by running

man home-configuration.nix
 

Once a configuration is successfully built, it can be activated. The activation performs the steps necessary to make the files, programs, and services available in your user environment. The home-manager switch @@ -501,14 +501,14 @@ chapter of the NixOS manual.

Table of ContentsdagOf and gvariant that are used, for example, by -programs.ssh.matchBlocks and dconf.settings.

hm.types.dagOf

Options of this type have attribute sets as values where each member +programs.ssh.matchBlocks and dconf.settings.

hm.types.dagOf

Options of this type have attribute sets as values where each member is a node in a directed acyclic graph (DAG). This allows the attribute set entries to express dependency relations among themselves. This can, for example, be used to control the order of match blocks in a OpenSSH client configuration or the order of activation script blocks in -home.activation.

A number of functions are provided to create DAG nodes. The +home.activation.

A number of functions are provided to create DAG nodes. The functions are shown below with examples using an option foo.bar of type hm.types.dagOf types.int.

Why are the session variables not set?

Home Manager is only able to set session variables automatically if it manages your Bash, Z shell, or fish shell configuration. To enable such -management you use programs.bash.enable, -programs.zsh.enable, or programs.fish.enable.

If you don’t want to let Home Manager manage your shell then you will +management you use programs.bash.enable, +programs.zsh.enable, or programs.fish.enable.

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"
@@ -951,7 +951,7 @@ in
     
      
      
-     Next
+     Next
     
     
       
diff --git a/nix-darwin-options.html b/nix-darwin-options.xhtml
similarity index 84%
rename from nix-darwin-options.html
rename to nix-darwin-options.xhtml
index 542fefb96..057202df3 100644
--- a/nix-darwin-options.html
+++ b/nix-darwin-options.xhtml
@@ -9,7 +9,7 @@
 
  
  
- 
+ 
  
  
   
- home-manager.extraSpecialArgs + home-manager.extraSpecialArgs
@@ -85,7 +85,7 @@ attribute set

- home-manager.sharedModules + home-manager.sharedModules
@@ -112,7 +112,7 @@ list of raw value

- home-manager.useGlobalPkgs + home-manager.useGlobalPkgs
@@ -141,7 +141,7 @@ boolean

- home-manager.useUserPackages + home-manager.useUserPackages
@@ -169,7 +169,7 @@ boolean

- home-manager.users + home-manager.users
@@ -193,7 +193,7 @@ attribute set of (Home Manager module)

- home-manager.verbose + home-manager.verbose
@@ -224,14 +224,14 @@ boolean


- + - + - +
Prev Prev     Next
Appendix B. NixOS Configuration Options  Home  Appendix D. Release Notes
diff --git a/nixos-options.html b/nixos-options.xhtml similarity index 87% rename from nixos-options.html rename to nixos-options.xhtml index 0a75aff67..66152cb31 100644 --- a/nixos-options.html +++ b/nixos-options.xhtml @@ -9,7 +9,7 @@ - +