nixpkgs/nixos/doc/manual/development/building-nixos.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>
Chunk NixOS manual [Squashed commits to make git blame etc. more likely to work. -ED] 2014-08-24 19:18:18 +02:00			`<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">`
nixos docs: format =) 2018-05-02 01:57:09 +02:00			`<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>.`
Chunk NixOS manual [Squashed commits to make git blame etc. more likely to work. -ED] 2014-08-24 19:18:18 +02:00			`<screen>`
doc: clarify building-nixos CD/DVD instructions 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. 2017-06-03 02:58:41 +02:00			`$ 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>`
nixos docs: format =) 2018-05-02 01:57:09 +02:00			`</para>`
			`<para>`
			`Before burning your CD/DVD, you can check the content of the image by`
			`mounting anywhere like suggested by the following command:`
Chunk NixOS manual [Squashed commits to make git blame etc. more likely to work. -ED] 2014-08-24 19:18:18 +02:00			`<screen>`
Manual: Explicitly mark commands that require to be run as root (#15589) * manual: Mark commands that require root Mark every command that requires to be run as root by prefixing them with '#' instead of '$'. * manual: Add note about commands that require root 2016-06-01 16:23:32 +02:00			`# mount -o loop -t iso9660 ./result/iso/cd.iso /mnt/iso</screen>`
nixos docs: format =) 2018-05-02 01:57:09 +02:00			`</para>`
Manual: Explicitly mark commands that require to be run as root (#15589) * manual: Mark commands that require root Mark every command that requires to be run as root by prefixing them with '#' instead of '$'. * manual: Add note about commands that require root 2016-06-01 16:23:32 +02:00			`</chapter>`