2020-10-12 00:22:58 +00:00
|
|
|
<book xmlns="http://docbook.org/ns/docbook"
|
|
|
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
|
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
|
|
|
version="5.0"
|
|
|
|
|
xml:id="book-home-manager-manual">
|
|
|
|
|
<info>
|
|
|
|
|
<title>Home Manager Manual</title>
|
|
|
|
|
</info>
|
|
|
|
|
<preface>
|
|
|
|
|
<title>Preface</title>
|
|
|
|
|
<para>
|
2021-11-04 16:42:44 +00:00
|
|
|
This manual will eventually describe how to install, use, and extend Home
|
2020-10-12 00:22:58 +00:00
|
|
|
Manager.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
If you encounter problems then please reach out on the IRC channel
|
2021-07-02 22:36:30 +00:00
|
|
|
<link xlink:href="https://webchat.oftc.net/?channels=home-manager">#home-manager</link>
|
|
|
|
|
hosted by <link xlink:href="https://oftc.net/">OFTC</link>.
|
2023-01-10 09:35:00 +00:00
|
|
|
There is also a <link xlink:href="https://matrix.to/#/%23hm:rycee.net">Matrix room</link>,
|
|
|
|
|
which is bridged to the IRC channel.
|
2020-10-12 00:22:58 +00:00
|
|
|
If your problem is caused by a bug in Home Manager then it should
|
|
|
|
|
be reported on the
|
|
|
|
|
<link xlink:href="https://github.com/nix-community/home-manager/issues">Home Manager issue tracker</link>.
|
|
|
|
|
</para>
|
|
|
|
|
<note>
|
|
|
|
|
<para>
|
2023-01-10 09:35:00 +00:00
|
|
|
Commands prefixed with <literal>$ sudo</literal> have to be run as root, either
|
2020-10-12 00:22:58 +00:00
|
|
|
requiring to login as root user or temporarily switching to it using
|
|
|
|
|
<literal>sudo</literal> for example.
|
|
|
|
|
</para>
|
|
|
|
|
</note>
|
|
|
|
|
</preface>
|
|
|
|
|
<xi:include href="installation.xml" />
|
2021-12-03 05:30:34 +00:00
|
|
|
<xi:include href="usage.xml" />
|
2023-01-10 09:35:00 +00:00
|
|
|
<xi:include href="nix-flakes.xml" />
|
2020-10-12 00:22:58 +00:00
|
|
|
<xi:include href="writing-modules.xml" />
|
|
|
|
|
<xi:include href="contributing.xml" />
|
|
|
|
|
<xi:include href="faq.xml" />
|
|
|
|
|
<appendix xml:id="ch-options">
|
|
|
|
|
<title>Configuration Options</title>
|
|
|
|
|
<xi:include href="./nmd-result/home-manager-options.xml" />
|
|
|
|
|
</appendix>
|
2021-07-02 22:36:30 +00:00
|
|
|
<appendix xml:id="ch-nixos-options">
|
|
|
|
|
<title>NixOS Module Options</title>
|
|
|
|
|
<xi:include href="./nmd-result/nixos-options.xml" />
|
|
|
|
|
</appendix>
|
|
|
|
|
<appendix xml:id="ch-nix-darwin-options">
|
|
|
|
|
<title>nix-darwin Module Options</title>
|
|
|
|
|
<xi:include href="./nmd-result/nix-darwin-options.xml" />
|
|
|
|
|
</appendix>
|
2020-10-12 00:22:58 +00:00
|
|
|
<appendix xml:id="ch-tools">
|
|
|
|
|
<title>Tools</title>
|
|
|
|
|
<xi:include href="./man-home-manager.xml" />
|
|
|
|
|
</appendix>
|
|
|
|
|
<xi:include href="./release-notes/release-notes.xml" />
|
|
|
|
|
</book>
|
