diff options
-rw-r--r-- | nixos/doc/manual/installation/installing-usb.xml | 20 |
1 files changed, 17 insertions, 3 deletions
diff --git a/nixos/doc/manual/installation/installing-usb.xml b/nixos/doc/manual/installation/installing-usb.xml index 31d51816e39b..122a4745f194 100644 --- a/nixos/doc/manual/installation/installing-usb.xml +++ b/nixos/doc/manual/installation/installing-usb.xml @@ -11,10 +11,24 @@ 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. If you're on macOS you can run <command>diskutil list</command> -to see the list of devices; the device you'll use for the USB must be ejected -before writing the image.</para> +block devices.</para> +<para>On macOS: +<programlisting> +$ diskutil list +[..] +/dev/diskN (external, physical): + #: TYPE NAME SIZE IDENTIFIER +[..] +$ diskutil unmountDisk diskN +Unmount of all volumes on diskN was successful +$ sudo dd bs=1m if=nix.iso of=/dev/rdiskN +</programlisting> +Using the 'raw' <command>rdiskN</command> device instead of <command>diskN</command> +completes in minutes instead of hours. After <command>dd</command> completes, a GUI +dialog "The disk you inserted was not readable by this computer" will pop up, which +can be ignored.</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 |