@@ -0,0 +1,39 @@
1+<chapter 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="ch-profiles">
6+ <title>Profiles</title>
7+ <para>
8+ In some cases, it may be desirable to take advantage of commonly-used,
9+ predefined configurations provided by nixpkgs, but different from those that
10+ come as default. This is a role fulfilled by NixOS's Profiles, which come as
11+ files living in <filename><nixpkgs/nixos/modules/profiles></filename>.
12+ That is to say, expected usage is to add them to the imports list of your
13+ <filename>/etc/configuration.nix</filename> as such:
14+ </para>
15+ <programlisting>
16+ imports = [
17+ <nixpkgs/nixos/modules/profiles/profile-name.nix>
18+ ];
19+ </programlisting>
20+ <para>
21+ Even if some of these profiles seem only useful in the context of
22+ install media, many are actually intended to be used in real installs.
23+ </para>
24+ <para>
25+ What follows is a brief explanation on the purpose and use-case for each
26+ profile. Detailing each option configured by each one is out of scope.
27+ </para>
28+ <xi:include href="profiles/all-hardware.xml" />
29+ <xi:include href="profiles/base.xml" />
30+ <xi:include href="profiles/clone-config.xml" />
31+ <xi:include href="profiles/demo.xml" />
32+ <xi:include href="profiles/docker-container.xml" />
33+ <xi:include href="profiles/graphical.xml" />
34+ <xi:include href="profiles/hardened.xml" />
35+ <xi:include href="profiles/headless.xml" />
36+ <xi:include href="profiles/installation-device.xml" />
37+ <xi:include href="profiles/minimal.xml" />
38+ <xi:include href="profiles/qemu-guest.xml" />
39+</chapter>