Preface
=======

This manual describes how to install, use and extend NixOS, a Linux
distribution based on the purely functional package management system
`Nix <https://nixos.org/nix>`_, that is composed
using modules and packages defined in the
`Nixpkgs <https://nixos.org/nixpkgs>`_ project.

Additional information regarding the Nix package manager and the Nixpkgs
project can be found in respectively the
`Nix manual <https://nixos.org/nix/manual>`_ and the
`Nixpkgs manual <https://nixos.org/nixpkgs/manual>`_.

If you encounter problems, please report them on the
``Discourse`` or
on the `#nixos channel on Freenode <irc://irc.freenode.net/#nixos>`_. Bugs should be
reported in
`NixOS’
GitHub issue tracker <https://github.com/NixOS/nixpkgs/issues>`_.

.. note::

   Commands prefixed with ``#`` have to be run as root, either
   requiring to login as root user or temporarily switching to it using
   ``sudo`` for example.