diff --git a/index.html b/index.html index 4286224bc..d18d5e226 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ -Home Manager Manual

Home Manager Manual


Preface
1. Installing Home Manager
1.1. Standalone installation
1.2. NixOS module
1.3. nix-darwin module
2. Writing Home Manager Modules
2.1. Option Types
3. Contributing
3.1. Getting started
3.2. Guidelines
3.2.1. Maintain backward compatibility
3.2.2. Keep forward compatibility in mind
3.2.3. Add only valuable options
3.2.4. Add relevant tests
3.2.5. Add relevant documentation
3.2.6. Add yourself as a module maintainer
3.2.7. Format your code
3.2.8. Format your commit messages
3.2.9. Format your news entries
3.2.10. Use conditional modules and news
3.2.11. Mind the license
3.3. Commits
3.4. Code Style
3.5. News
3.6. Tests
4. Frequently Asked Questions (FAQ)
4.1. Why is there a collision error when switching generation?
4.2. Why are the session variables not set?
4.3. How to set up a configuration for multiple users/machines?
4.4. Why do I get an error message about ca.desrt.dconf?
4.5. How do I install packages from Nixpkgs unstable?
4.6. How do I override the package used by a module?
A. Configuration Options
B. NixOS Module Options
C. nix-darwin Module Options
D. Tools
home-manager - — reconfigure a user environment
E. Release Notes
E.1. Release 21.11
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 21.05
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 20.09
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 20.03
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 19.09
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 19.03
E.6.1. Highlights
E.6.2. State Version Changes
E.7. Release 18.09

Preface

+Home Manager Manual

Home Manager Manual


Preface
1. Installing Home Manager
1.1. Standalone installation
1.2. NixOS module
1.3. nix-darwin module
2. Writing Home Manager Modules
2.1. Option Types
3. Contributing
3.1. Getting started
3.2. Guidelines
3.2.1. Maintain backward compatibility
3.2.2. Keep forward compatibility in mind
3.2.3. Add only valuable options
3.2.4. Add relevant tests
3.2.5. Add relevant documentation
3.2.6. Add yourself as a module maintainer
3.2.7. Format your code
3.2.8. Format your commit messages
3.2.9. Format your news entries
3.2.10. Use conditional modules and news
3.2.11. Mind the license
3.3. Commits
3.4. Code Style
3.5. News
3.6. Tests
4. Frequently Asked Questions (FAQ)
4.1. Why is there a collision error when switching generation?
4.2. Why are the session variables not set?
4.3. How to set up a configuration for multiple users/machines?
4.4. Why do I get an error message about ca.desrt.dconf?
4.5. How do I install packages from Nixpkgs unstable?
4.6. How do I override the package used by a module?
A. Configuration Options
B. NixOS Module Options
C. nix-darwin Module Options
D. Tools
home-manager + — reconfigure a user environment
E. Release Notes
E.1. Release 21.11
E.1.1. Highlights
E.1.2. State Version Changes
E.2. Release 21.05
E.2.1. Highlights
E.2.2. State Version Changes
E.3. Release 20.09
E.3.1. Highlights
E.3.2. State Version Changes
E.4. Release 20.03
E.4.1. Highlights
E.4.2. State Version Changes
E.5. Release 19.09
E.5.1. Highlights
E.5.2. State Version Changes
E.6. Release 19.03
E.6.1. Highlights
E.6.2. State Version Changes
E.7. Release 18.09

Preface

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

diff --git a/options.html b/options.html index 688da9ff0..588a82157 100644 --- a/options.html +++ b/options.html @@ -6409,6 +6409,67 @@ for options. }

Declared by:

<home-manager/modules/programs/qutebrowser.nix> +
programs.rbw.enable

Whether to enable rwb, a CLI Bitwarden client.

Type: boolean

Default: + false +

Example: + true +

Declared by:

+ <home-manager/modules/programs/rbw.nix> +
programs.rbw.package

Package providing the rbw tool and its +rbw-agent daemon. +

Type: package

Default: + pkgs.rbw +

Declared by:

+ <home-manager/modules/programs/rbw.nix> +
programs.rbw.settings

rbw configuration, if not defined the configuration will not be +managed by Home Manager. +

Type: null or JSON value

Default: + null +

Example:

{
+  email = "name@example.com";
+  lock_timeout = 300;
+  pinentry = "gnome3";
+}
+

Declared by:

+ <home-manager/modules/programs/rbw.nix> +
programs.rbw.settings.base_url

The base-url for a self-hosted bitwarden installation.

Type: null or string

Default: + null +

Example: + "bitwarden.example.com" +

Declared by:

+ <home-manager/modules/programs/rbw.nix> +
programs.rbw.settings.email

The email address for your bitwarden account.

Type: string

Example: + "name@example.com" +

Declared by:

+ <home-manager/modules/programs/rbw.nix> +
programs.rbw.settings.identity_url

The identity url for your bitwarden installation.

Type: null or string

Default: + null +

Example: + "identity.example.com" +

Declared by:

+ <home-manager/modules/programs/rbw.nix> +
programs.rbw.settings.lock_timeout

The amount of time that your login information should be cached. +

Type: unsigned integer, meaning >=0

Default: + 3600 +

Example: + 300 +

Declared by:

+ <home-manager/modules/programs/rbw.nix> +
programs.rbw.settings.pinentry

Which pinentry interface to use. Beware that +pinentry-gnome3 may not work on non-Gnome +systems. You can fix it by adding the following to your +system configuration: +

+services.dbus.packages = [ pkgs.gcr ];
+

+For this reason, the default is gtk2 for +now. +

Type: package or one of "curses", "tty", "gtk2", "qt", "emacs", "gnome3"

Default: + "gtk2" +

Example: + "gnome3" +

Declared by:

+ <home-manager/modules/programs/rbw.nix>
programs.readline.enable

Whether to enable readline.

Type: boolean

Default: false

Example: diff --git a/tools.html b/tools.html index 1e0a2ef6f..afaf7bf3c 100644 --- a/tools.html +++ b/tools.html @@ -1,6 +1,6 @@ -Appendix D. Tools

Appendix D. Tools

home-manager - — reconfigure a user environment

Name

home-manager +Appendix D. Tools

Appendix D. Tools

home-manager + — reconfigure a user environment

Name

home-manager — reconfigure a user environment

Synopsis

home-manager { build | @@ -76,7 +76,7 @@ | --verbose } - ]

Description

+ ]

Description

This command updates the user environment so that it corresponds to the configuration specified in ~/.config/nixpkgs/home.nix or ~/.config/nixpkgs/flake.nix.

@@ -141,7 +141,7 @@ available for immediate garbage collection.

-

Options

+

Options

The tool accepts the options

-A attrPath @@ -240,15 +240,15 @@ --verbose

Activates verbose output. -

Files

+

Files

~/.local/share/home-manager/news-read-ids

Identifiers of news items that have been shown. Can be deleted to reset the read news indicator. -

Bugs

+

Bugs

Please report any bugs on the project issue tracker. -

See also

+

See also

home-configuration.nix(5)

\ No newline at end of file