pyrox.dev
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="sec-building-cd">
6
7<title>Building Your Own NixOS CD</title>
8
9<para>Building a NixOS CD is as easy as configuring your own computer. The
10idea is to use another module which will replace
11your <filename>configuration.nix</filename> to configure the system that
12would be installed on the CD.</para>
13
14<para>Default CD/DVD configurations are available
15inside <filename>nixos/modules/installer/cd-dvd</filename>. To build them
16you have to set <envar>NIXOS_CONFIG</envar> before
17running <command>nix-build</command> to build the ISO.
18
19<screen>
20$ nix-build -A config.system.build.isoImage -I nixos-config=modules/installer/cd-dvd/installation-cd-minimal.nix</screen>
21
22</para>
23
24<para>Before burning your CD/DVD, you can check the content of the image by mounting anywhere like
25suggested by the following command:
26
27<screen>
28# mount -o loop -t iso9660 ./result/iso/cd.iso /mnt/iso</screen>
29
30</para>
31
32</chapter>