nordic-dev.net/nixpkgs
nordic-dev.net/nixpkgs
2
0
Fork 0
mirror of https://github.com/NixOS/nixpkgs.git synced 2024-11-30 19:02:57 +00:00
Code Issues Packages Projects Releases Wiki Activity
f83198ab9c
nixpkgs/nixos/doc/manual/installation/installing-usb.section.md
davidak f701bd5986 nixos/doc: improve install instructions 
- Update download URLs
- Replace "USB stick"/"USB Drive" with "USB flash drive" as that seem more correct

  https://en.wikipedia.org/wiki/USB_flash_drive
  https://elementary.io/docs/installation#choose-operating-system

- Don't mention CD as easiest option anymore,
  as all modern systems should be able to boot from USB,
  but many don't have a CD drive. Burning CDs is also usually wasteful as you
  can't burn them again.
- Remove link to NixOS Wiki (Making_the_installation_media) as it is not needed
- Add Etcher and USBImager as graphical tools to create install drive
- Make dd command consistent and use block size of 4 MB for faster flashing
- More consistent text
- Add instructions for "Booting from the install medium"

  Inspired by 9a91b0f495/docs/installation.md (booting-from-the-install-drive-booting-from-the-installation-medium-clear-float-2)

- Add instructions for "Graphical Installation"
- Restructure headings and anchors for "Manual Installation"
- Adding legacy anchors for "Manual Installation" to not break links

Co-authored-by: j-k <dev@j-k.io>
Co-authored-by: Sandro <sandro.jaeckel@gmail.com>
Co-authored-by: Robert Schütz <github@dotlambda.de>
Co-authored-by: Jörg Thalheim <Mic92@users.noreply.github.com>
Co-authored-by: Thiago Kenji Okada <thiagokokada@gmail.com>
2022-10-26 14:22:15 +02:00

2.3 KiB
Raw Blame History

Booting from a USB flash drive

The image has to be written verbatim to the USB flash drive for it to be bootable on UEFI and BIOS systems. Here are the recommended tools to do that.

Creating bootable USB flash drive with a graphical tool

Etcher is a popular and user-friendly tool. It works on Linux, Windows and macOS.

Download it from balena.io, start the program, select the downloaded NixOS ISO, then select the USB flash drive and flash it.

::: {.warning} Etcher reports errors and usage statistics by default, which can be disabled in the settings. :::

An alternative is USBImager, which is very simple and does not connect to the internet. Download the version with write-only (wo) interface for your system. Start the program, select the image, select the USB flash drive and click "Write".

Creating bootable USB flash drive from a Terminal on Linux

  1. Plug in the USB flash drive.
  2. Find the corresponding device with lsblk. You can distinguish them by their size.
  3. Make sure all partitions on the device are properly unmounted. Replace sdX with your device (e.g. sdb).
sudo umount /dev/sdX*
  1. Then use the dd utility to write the image to the USB flash drive.
sudo dd if=<path-to-image> of=/dev/sdX bs=4M conv=fsync

Creating bootable USB flash drive from a Terminal on macOS

  1. Plug in the USB flash drive.
  2. Find the corresponding device with diskutil list. You can distinguish them by their size.
  3. Make sure all partitions on the device are properly unmounted. Replace diskX with your device (e.g. disk1).
diskutil unmountDisk diskX
  1. Then use the dd utility to write the image to the USB flash drive.
sudo dd if=<path-to-image> of=/dev/rdiskX bs=4m

After dd completes, a GUI dialog "The disk you inserted was not readable by this computer" will pop up, which can be ignored.

::: {.note} Using the 'raw' rdiskX device instead of diskX with dd completes in minutes instead of hours. :::

  1. Eject the disk when it is finished.
diskutil eject /dev/diskX