about summary refs log tree commit diff
path: root/nixos/doc
diff options
context:
space:
mode:
authorRastus Vernon <rastus.vernon@protonmail.ch>2016-03-22 22:32:03 -0400
committerVladimír Čunát <vcunat@gmail.com>2016-04-02 17:41:38 +0200
commitd6998b06744064deb7ed6ea38a062c51638d33bc (patch)
treecfb84a5ba848f7338662ad784cc892d4cd9cdf47 /nixos/doc
parente6ccb6aa2ede00fb36a9bdc5c15e9fc3c46e307d (diff)
downloadnixlib-d6998b06744064deb7ed6ea38a062c51638d33bc.tar
nixlib-d6998b06744064deb7ed6ea38a062c51638d33bc.tar.gz
nixlib-d6998b06744064deb7ed6ea38a062c51638d33bc.tar.bz2
nixlib-d6998b06744064deb7ed6ea38a062c51638d33bc.tar.lz
nixlib-d6998b06744064deb7ed6ea38a062c51638d33bc.tar.xz
nixlib-d6998b06744064deb7ed6ea38a062c51638d33bc.tar.zst
nixlib-d6998b06744064deb7ed6ea38a062c51638d33bc.zip
nixos manual: recommend use of dd for writing the image
Unetbootin works by altering the image and placing a boot loader on it.
For this reason, it cannot work with UEFI and the installation guides
for other distributions (incl. Debian and Fedora) recommend against
using it.

Since dd writes the image verbatim to the drive, and not just the files,
it is not necessary to change the label after using it for UEFI
installations.

vcunat: tiny changes to the PR. Close #14139.
Diffstat (limited to 'nixos/doc')
-rw-r--r--nixos/doc/manual/installation/installing-usb.xml16
1 files changed, 12 insertions, 4 deletions
diff --git a/nixos/doc/manual/installation/installing-usb.xml b/nixos/doc/manual/installation/installing-usb.xml
index 5def6e8753fe..a4b5dafbed16 100644
--- a/nixos/doc/manual/installation/installing-usb.xml
+++ b/nixos/doc/manual/installation/installing-usb.xml
@@ -7,10 +7,18 @@
 <title>Booting from a USB Drive</title>
 
 <para>For systems without CD drive, the NixOS live CD can be booted from
-a USB stick. For non-UEFI installations,
-<link xlink:href="http://unetbootin.sourceforge.net/">unetbootin</link>
-will work. For UEFI installations, you should mount the ISO, copy its contents
-verbatim to your drive, then either:
+a USB stick. You can use the <command>dd</command> utility to write the image:
+<command>dd if=<replaceable>path-to-image</replaceable>
+of=<replaceable>/dev/sdb</replaceable></command>. Be careful about specifying the
+correct drive; you can use the <command>lsblk</command> command to get a list of
+block devices.</para>
+
+<para>The <command>dd</command> utility will write the image verbatim to the drive,
+making it the recommended option for both UEFI and non-UEFI installations. For
+non-UEFI installations, you can alternatively use
+<link xlink:href="http://unetbootin.sourceforge.net/">unetbootin</link>. If you
+cannot use <command>dd</command> for a UEFI installation, you can also mount the
+ISO, copy its contents verbatim to your drive, then either:
 
 <itemizedlist>
   <listitem>