2020-04-24 23:36:52 +00:00
|
|
|
|
<preface xmlns="http://docbook.org/ns/docbook"
|
|
|
|
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
|
|
|
|
xml:id="preface">
|
|
|
|
|
|
<title>Preface</title>
|
|
|
|
|
|
<para>
|
|
|
|
|
|
This manual describes how to install, use and extend NixOS, a Linux
|
|
|
|
|
|
distribution based on the purely functional package management system
|
|
|
|
|
|
<link xlink:href="https://nixos.org/nix">Nix</link>, that is composed
|
|
|
|
|
|
using modules and packages defined in the
|
|
|
|
|
|
<link xlink:href="https://nixos.org/nixpkgs">Nixpkgs</link> project.
|
|
|
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
|
|
|
Additional information regarding the Nix package manager and the Nixpkgs
|
|
|
|
|
|
project can be found in respectively the
|
|
|
|
|
|
<link xlink:href="https://nixos.org/nix/manual">Nix manual</link> and the
|
|
|
|
|
|
<link xlink:href="https://nixos.org/nixpkgs/manual">Nixpkgs manual</link>.
|
|
|
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
|
|
|
If you encounter problems, please report them on the
|
|
|
|
|
|
<literal
|
2021-07-14 22:03:04 +00:00
|
|
|
|
xlink:href="https://discourse.nixos.org">Discourse</literal>,
|
|
|
|
|
|
the <link
|
|
|
|
|
|
xlink:href="https://matrix.to/#nix:nixos.org">Matrix room</link>,
|
|
|
|
|
|
or on the <link
|
|
|
|
|
|
xlink:href="irc://irc.libera.chat/#nixos">
|
|
|
|
|
|
<literal>#nixos</literal> channel on Libera.Chat</link>.
|
|
|
|
|
|
Alternatively, consider <link
|
2021-02-05 17:12:51 +00:00
|
|
|
|
xlink:href="#chap-contributing">
|
|
|
|
|
|
contributing to this manual</link>. Bugs should be
|
2020-04-24 23:36:52 +00:00
|
|
|
|
reported in
|
|
|
|
|
|
<link
|
|
|
|
|
|
xlink:href="https://github.com/NixOS/nixpkgs/issues">NixOS’
|
|
|
|
|
|
GitHub issue tracker</link>.
|
|
|
|
|
|
</para>
|
|
|
|
|
|
<note>
|
|
|
|
|
|
<para>
|
|
|
|
|
|
Commands prefixed with <literal>#</literal> have to be run as root, either
|
|
|
|
|
|
requiring to login as root user or temporarily switching to it using
|
|
|
|
|
|
<literal>sudo</literal> for example.
|
|
|
|
|
|
</para>
|
|
|
|
|
|
</note>
|
|
|
|
|
|
</preface>
|
