pyrox.dev
1<book xmlns="http://docbook.org/ns/docbook"
2 xmlns:xlink="http://www.w3.org/1999/xlink"
3 xmlns:xi="http://www.w3.org/2001/XInclude"
4 version="5.0"
5 xml:id="book-nixos-manual">
6 <info>
7 <title>NixOS Manual</title>
8 <subtitle>Version <xi:include href="./generated/version" parse="text" />
9 </subtitle>
10 </info>
11 <preface xml:id="preface">
12 <title>Preface</title>
13 <para>
14 This manual describes how to install, use and extend NixOS, a Linux
15 distribution based on the purely functional package management system Nix.
16 </para>
17 <para>
18 If you encounter problems, please report them on the
19 <literal
20 xlink:href="https://discourse.nixos.org">Discourse</literal>
21 or on the <link
22 xlink:href="irc://irc.freenode.net/#nixos">
23 <literal>#nixos</literal> channel on Freenode</link>. Bugs should be
24 reported in
25 <link
26 xlink:href="https://github.com/NixOS/nixpkgs/issues">NixOS’
27 GitHub issue tracker</link>.
28 </para>
29 <note>
30 <para>
31 Commands prefixed with <literal>#</literal> have to be run as root, either
32 requiring to login as root user or temporarily switching to it using
33 <literal>sudo</literal> for example.
34 </para>
35 </note>
36 </preface>
37 <xi:include href="installation/installation.xml" />
38 <xi:include href="configuration/configuration.xml" />
39 <xi:include href="administration/running.xml" />
40<!-- <xi:include href="userconfiguration.xml" /> -->
41 <xi:include href="development/development.xml" />
42 <appendix xml:id="ch-options">
43 <title>Configuration Options</title>
44 <xi:include href="./generated/options-db.xml"
45 xpointer="configuration-variable-list" />
46 </appendix>
47 <xi:include href="release-notes/release-notes.xml" />
48</book>