forked from mirrors/nixpkgs
4bee34dcc5
This change updates the instructions for building a NixOS ISO so that it's clear how to do it. Previously, the instructions stated to set NIXOS_CONFIG prior to running `nix-build`, yet the example provided by-passed NIXOS_CONFIG anyway. But the *really* important missing piece is the need for nixos/default.nix. See #21840. This change removes the NIXOS_CONFIG verbiage, and adds steps to clone nixpkgs and (most importantly) cd'ing into nixpkgs/nixos. That way, the reader may think: *Oh, so I need a default.nix and a configuration.nix. Ahhh, OK.* I purposely added the redundant default.nix argument.
33 lines
1 KiB
XML
33 lines
1 KiB
XML
<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>
|
|
$ git clone https://github.com/NixOS/nixpkgs.git
|
|
$ cd nixpkgs/nixos
|
|
$ 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>
|
|
# mount -o loop -t iso9660 ./result/iso/cd.iso /mnt/iso</screen>
|
|
|
|
</para>
|
|
|
|
</chapter>
|