about summary refs log tree commit diff
path: root/nixpkgs/nixos/doc/manual/development/building-nixos.xml
blob: d58b6354d1d361ed2e0615c3760dbf1cfe748ad8 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<chapter xmlns="http://docbook.org/ns/docbook"
        xmlns:xlink="http://www.w3.org/1999/xlink"
        xmlns:xi="http://www.w3.org/2001/XInclude"
        version="5.0"
        xml:id="sec-building-cd">
 <title>Building Your Own NixOS CD</title>
 <para>
  Building a NixOS CD is as easy as configuring your own computer. The idea is
  to use another module which will replace your
  <filename>configuration.nix</filename> to configure the system that would be
  installed on the CD.
 </para>
 <para>
  Default CD/DVD configurations are available inside
  <filename>nixos/modules/installer/cd-dvd</filename>.
<screen>
<prompt>$ </prompt>git clone https://github.com/NixOS/nixpkgs.git
<prompt>$ </prompt>cd nixpkgs/nixos
<prompt>$ </prompt>nix-build -A config.system.build.isoImage -I nixos-config=modules/installer/cd-dvd/installation-cd-minimal.nix default.nix</screen>
 </para>
 <para>
  Before burning your CD/DVD, you can check the content of the image by
  mounting anywhere like suggested by the following command:
<screen>
<prompt># </prompt>mount -o loop -t iso9660 ./result/iso/cd.iso /mnt/iso</screen>
 </para>
 <para>
 If you want to customize your NixOS CD in more detail, or generate other kinds
 of images, you might want to check out <link
 xlink:href="https://github.com/nix-community/nixos-generators">nixos-generators</link>. This can also be a good starting point when you want to use Nix to build a
 'minimal' image that doesn't include a NixOS installation.
 </para>
</chapter>