pyrox.dev
1<preface xmlns="http://docbook.org/ns/docbook"
2 xmlns:xlink="http://www.w3.org/1999/xlink"
3 xml:id="preface">
4 <title>Preface</title>
5 <para>
6 This manual describes how to install, use and extend NixOS, a Linux
7 distribution based on the purely functional package management system
8 <link xlink:href="https://nixos.org/nix">Nix</link>, that is composed
9 using modules and packages defined in the
10 <link xlink:href="https://nixos.org/nixpkgs">Nixpkgs</link> project.
11 </para>
12 <para>
13 Additional information regarding the Nix package manager and the Nixpkgs
14 project can be found in respectively the
15 <link xlink:href="https://nixos.org/nix/manual">Nix manual</link> and the
16 <link xlink:href="https://nixos.org/nixpkgs/manual">Nixpkgs manual</link>.
17 </para>
18 <para>
19 If you encounter problems, please report them on the
20 <literal
21 xlink:href="https://discourse.nixos.org">Discourse</literal>,
22 the <link
23 xlink:href="https://matrix.to/#nix:nixos.org">Matrix room</link>,
24 or on the <link
25 xlink:href="irc://irc.libera.chat/#nixos">
26 <literal>#nixos</literal> channel on Libera.Chat</link>.
27 Alternatively, consider <link
28 xlink:href="#chap-contributing">
29 contributing to this manual</link>. Bugs should be
30 reported in
31 <link
32 xlink:href="https://github.com/NixOS/nixpkgs/issues">NixOS’
33 GitHub issue tracker</link>.
34 </para>
35 <note>
36 <para>
37 Commands prefixed with <literal>#</literal> have to be run as root, either
38 requiring to login as root user or temporarily switching to it using
39 <literal>sudo</literal> for example.
40 </para>
41 </note>
42</preface>