diff options
author | Ryan Mulligan <ryan@ryantm.com> | 2020-12-22 21:56:46 -0800 |
---|---|---|
committer | Jonathan Ringer <jonringer@users.noreply.github.com> | 2021-05-22 18:14:49 -0700 |
commit | 6c14851943fe55da9df88a502d1e1fe2271d9666 (patch) | |
tree | 3508d24c58f5a5402650446aaae471f2243c24b4 /nixos/doc/manual/from_md/development/building-nixos.chapter.xml | |
parent | ff1ded3e2047268a55d3443459cda01cf9242e45 (diff) | |
download | nixpkgs-6c14851943fe55da9df88a502d1e1fe2271d9666.tar nixpkgs-6c14851943fe55da9df88a502d1e1fe2271d9666.tar.gz nixpkgs-6c14851943fe55da9df88a502d1e1fe2271d9666.tar.bz2 nixpkgs-6c14851943fe55da9df88a502d1e1fe2271d9666.tar.lz nixpkgs-6c14851943fe55da9df88a502d1e1fe2271d9666.tar.xz nixpkgs-6c14851943fe55da9df88a502d1e1fe2271d9666.tar.zst nixpkgs-6c14851943fe55da9df88a502d1e1fe2271d9666.zip |
nixos/doc: add md-to-db.sh, convert "Building Your Own NixOS CD" to CommonMark
Diffstat (limited to 'nixos/doc/manual/from_md/development/building-nixos.chapter.xml')
-rw-r--r-- | nixos/doc/manual/from_md/development/building-nixos.chapter.xml | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/nixos/doc/manual/from_md/development/building-nixos.chapter.xml b/nixos/doc/manual/from_md/development/building-nixos.chapter.xml new file mode 100644 index 00000000000..ceb744447da --- /dev/null +++ b/nixos/doc/manual/from_md/development/building-nixos.chapter.xml @@ -0,0 +1,33 @@ +<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" 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 + <literal>configuration.nix</literal> to configure the system that + would be installed on the CD. + </para> + <para> + Default CD/DVD configurations are available inside + <literal>nixos/modules/installer/cd-dvd</literal> + </para> + <programlisting> +$ 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 +</programlisting> + <para> + Before burning your CD/DVD, you can check the content of the image + by mounting anywhere like suggested by the following command: + </para> + <programlisting> +# mount -o loop -t iso9660 ./result/iso/cd.iso /mnt/iso</screen> +</programlisting> + <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 <quote>minimal</quote> image that doesn’t include a NixOS + installation. + </para> +</chapter> |