USB flash installation medium: Difference between revisions

From ArchWiki
m (Correct slight grammar mistake)
 
(291 intermediate revisions by 81 users not shown)
Line 1: Line 1:
[[Category:Getting and installing Arch]]
[[Category:Installation process]]
[[ar:USB flash installation media]]
[[bg:USB flash installation media]]
[[de:Installation von einem USB-Stick]]
[[de:Installation von einem USB-Stick]]
[[es:USB flash installation media]]
[[es:USB flash installation medium]]
[[fr:Créer une clef USB avec l'ISO Arch Linux]]
[[fr:USB flash installation medium]]
[[it:USB flash installation media]]
[[ja:USB インストールメディア]]
[[ja:USB インストールメディア]]
[[ro:Instalare prin USB]]
[[pt:USB flash installation medium]]
[[ru:USB flash installation media]]
[[ru:USB flash installation medium]]
[[tr:USB ile kurulum]]
[[tr:USB flash installation medium]]
[[zh-hans:USB flash installation media]]
[[zh-hans:USB flash installation medium]]
[[zh-hant:USB flash installation media]]
{{Related articles start}}
{{Related articles start}}
{{Related|CD Burning}}
{{Related|CD Burning}}
Line 17: Line 13:
{{Related|Multiboot USB drive}}
{{Related|Multiboot USB drive}}
{{Related articles end}}
{{Related articles end}}
This page discusses various multi-platform methods on how to create an Arch Linux Installer USB drive (also referred to as ''"flash drive", "USB stick", "USB key"'', etc) for booting in BIOS and UEFI systems. The result will be a [[Wikipedia:Live USB|live USB]] system that can be used for installing Arch Linux, system maintenance or for recovery purposes, and that, because of using [[Overlayfs]] for {{ic|/}}, will discard all changes once the computer shuts down.


This page discusses various multi-platform methods on how to create an Arch Linux Installer USB drive (also referred to as ''"flash drive", "USB stick", "USB key"'', etc) for booting in BIOS and UEFI systems. The result will be a LiveUSB (LiveCD-like) system that can be used for installing Arch Linux, system maintenance or for recovery purposes, and that, because of the nature of [[Wikipedia:SquashFS|SquashFS]], will discard all changes once the computer shuts down.
If you would like to run a full install of Arch Linux from a USB drive (i.e. with persistent settings), see [[Install Arch Linux on a removable medium]]. If you would like to use your bootable Arch Linux USB stick as a rescue USB, see [[chroot]].


If you would like to run a full install of Arch Linux from a USB drive (i.e. with persistent settings), see [[Installing Arch Linux on a USB key]]. If you would like to use your bootable Arch Linux USB stick as a rescue USB, see [[Change root]].
Before following any of these steps, download the ISO from https://archlinux.org/download/ and [[Installation guide#Verify signature|verify its integrity]].


== BIOS and UEFI Bootable USB ==
== Using the ISO as is (BIOS and UEFI) ==


=== Using dd ===
{{Warning|This will irrevocably delete all data on your USB flash drive, so make sure you do not have any important files on the flash drive before doing this.}}
{{Note|This method is recommended due to its simplicity. If it does not work, switch to the alternative method [[#Using manual formatting]] below.}}


{{Warning|This will irrevocably destroy all data on {{ic|/dev/'''sdx'''}}. To restore the USB drive as an empty, usable storage device after using the Arch ISO image, the iso9660 filesystem signature needs to be removed by running {{ic|wipefs --all /dev/'''sdx'''}} as root, before [[repartition]]ing and [[reformat]]ing the USB drive.}}
{{Note|If, instead of a USB flash drive or an SD card, you want to write the ISO to a hard disk drive or a solid state drive, make sure the drive's logical sector size is not larger than 2048 bytes (the [[Wikipedia:ISO 9660|ISO 9660]] sector size) and aligns to it. This means the ISO cannot be written to a 4Kn [[Advanced Format]] drive using this method.}}


==== In GNU/Linux ====
=== In GNU/Linux ===
 
==== Using basic command line utilities ====
 
This method is recommended due to its simplicity and universal availability, since these tools are part of {{Pkg|coreutils}} (pulled in by the {{Pkg|base}} [[meta package]]).
 
Find out the name of your USB drive with {{ic|ls -l /dev/disk/by-id/usb-*}} and check with {{ic|lsblk}} to make sure that it is '''not''' mounted.
 
Run one of the following commands, replacing {{ic|/dev/disk/by-id/usb-''My_flash_drive''}} with your drive, e.g. {{ic|/dev/disk/by-id/usb-Kingston_DataTraveler_2.0_408D5C1654FDB471E98BED5C-0:0}}. (Do '''not''' append a partition number, so do '''not''' use something like {{ic|/dev/disk/by-id/usb-Kingston_DataTraveler_2.0_408D5C1654FDB471E98BED5C-0:0'''-part1'''}} or {{ic|/dev/sdb'''1'''}}):
 
* using {{man|1|cat}}: {{bc|# cat ''path/to/''archlinux-''version''-x86_64.iso > /dev/disk/by-id/usb-''My_flash_drive''}}
* using {{man|1|cp}}: {{bc|# cp ''path/to/''archlinux-''version''-x86_64.iso /dev/disk/by-id/usb-''My_flash_drive''}}
* using [[dd]]: {{bc|1=# dd bs=4M if=''path/to/''archlinux-''version''-x86_64.iso of=/dev/disk/by-id/usb-''My_flash_drive'' conv=fsync oflag=direct status=progress}}
* using [[tee]]: {{bc|# tee < ''path/to/''archlinux-''version''-x86_64.iso > /dev/disk/by-id/usb-''My_flash_drive''}}
* using {{Pkg|pv}}: {{bc|# pv ''path/to/''archlinux-''version''-x86_64.iso > /dev/disk/by-id/usb-''My_flash_drive''}}
 
See [https://unix.stackexchange.com/questions/224277/is-it-better-to-use-cat-dd-pv-or-another-procedure-to-copy-a-cd-dvd/224314#224314] and [https://www.vidarholen.net/contents/blog/?p=479] for a comparison and perspective on the use of those tools and why ''dd'' may be the least adapted one.
 
{{Tip|
* Executing {{ic|sync}} with root privileges after the respective command ensures buffers are fully written to the device before you remove it.
* If the UEFI version of the USB's Arch ISO hangs or is unable to load, try repeating the medium creation process on the same USB drive one or more times. If this does not work, you may also try updating your motherboard's firmware.}}
 
{{Note|To restore the USB drive as an empty, usable storage device after using the Arch ISO image, the ISO 9660 filesystem signature needs to be removed by running {{ic|wipefs --all /dev/disk/by-id/usb-''My_flash_drive''}} as root, before [[repartition]]ing and [[reformat]]ting the USB drive.}}
 
==== Using KDE ISO Image Writer ====
 
KDE ISO Image Writer can be downloaded via {{Pkg|isoimagewriter}}. It can auto-detect the USB-drive and you need to manually select a ISO file. It is recommended to use ''.sig'' file to signature but it can be skipped by clicking "create".
 
==== Using GNOME Disk Utility ====
 
Linux distributions running GNOME can easily make a live CD through {{Pkg|nautilus}} and {{Pkg|gnome-disk-utility}}.  Simply right-click on the ''.iso'' file, and select ''Open With Disk Image Writer''.  When GNOME Disk Utility opens, specify the flash drive from the ''Destination'' drop-down menu and click ''Start Restoring''.
 
==== Using MultiWriter ====
 
{{pkg|gnome-multi-writer}} is a simple [[GTK]]3 based graphical tool to write an ISO file to one or multiple USB devices at once.
 
==== Using Kindd ====
 
[https://github.com/LinArcX/Kindd Kindd] is a Qt based graphical frontend for dd. It is available as {{AUR|kindd}}.
 
==== Using Popsicle ====
 
[https://github.com/pop-os/popsicle Popsicle] is a tool made for flashing ISO files to multiple USB devices in parallel by the PopOS development team. It is written in Rust and uses GTK. It is available as {{AUR|popsicle}}.
 
==== Using SUSE Studio ImageWriter ====
 
[https://github.com/openSUSE/imagewriter SUSE Studio ImageWriter] is a Qt based tool made by the OpenSUSE development team. It is available as {{AUR|imagewriter}}.
 
==== Using xorriso-dd-target ====
 
[https://dev.lovelyhq.com/libburnia/libisoburn/raw/master/xorriso-dd-target/xorriso-dd-target xorriso-dd-target] (from {{Pkg|libisoburn}}) is a shell script which attempts to reduce the risk of overwriting the wrong storage device. Its safest mode is named {{ic|-plug_test}}. For example, to use it as a regular user who can elevate to root using [[sudo]]:
 
$ xorriso-dd-target -with_sudo -plug_test -DO_WRITE -image_file archlinux-''version''-x86_64.iso
 
See {{man|1|xorriso-dd-target}} for details.
 
==== Using USBImager ====
 
[https://gitlab.com/bztsrc/usbimager/ USBImager] is a multiplatform graphical application that writes and verifies compressed disk images to USB drives, and creates backups. It is available as {{AUR|usbimager}}.
 
=== In Windows ===


{{Tip|Find out the name of your USB drive with {{ic|lsblk}}. Make sure that it is '''not''' mounted.}}
==== Using KDE ISO Image Writer ====


Run the following command, replacing {{ic|/dev/'''sdx'''}} with your drive, e.g. {{ic|/dev/sdb}}. (do '''not''' append a partition number, so do '''not''' use something like {{ic|/dev/sdb'''1'''}}):
KDE ISO Image Writer can be downloaded as ''.exe'' file at [https://apps.kde.org/isoimagewriter/ isoimagewriter]. It can auto-detect the USB-drive and you need to manually select a ISO file. It is recommended to use ''.sig'' file to signature but it can be skipped by clicking "create".


# dd bs=4M if=/path/to/archlinux.iso of=/dev/'''sdx''' status=progress && sync
==== Using win32diskimager ====


Wait for the command ''sync'' to complete before unplugging the USB drive to ensure the data was written completely.
[https://sourceforge.net/projects/win32diskimager/ win32diskimager] is another graphical tool for writing images to USB sticks or SD/CF cards from Windows. Select your ISO image and the target USB drive letter (you may have to format it first to assign it a drive letter), and click ''Write''.


See [[Core utilities#dd]] for more information about {{ic|dd}}.
==== Using USBwriter ====


==== In Windows ====
This method does not require any workaround and is as straightforward as {{ic|dd}} under Linux. Just download the Arch Linux ISO, and with local administrator rights use the [https://sourceforge.net/p/usbwriter/wiki/Documentation/ USBwriter] utility to write to your USB flash memory.


===== Using Rufus =====  
==== Using USBImager ====
[https://rufus.akeo.ie/ Rufus] is a multi-purpose USB iso writer. Simply select the Arch Linux ISO, the USB drive you want to create the bootable Arch Linux onto and click start.


Since Rufus does not care if the drive is properly formatted or not and provides a GUI it may be the easiest and most robust tool to use.
[https://gitlab.com/bztsrc/usbimager/ USBImager] is a multiplatform graphical application that writes and verifies compressed disk images to USB drives, and creates backups.


===== Using USBwriter =====
==== Using Rufus ====


This method does not require any workaround and is as straightforward as {{ic|dd}} under Linux. Just download the Arch Linux ISO, and with local administrator rights use the [http://sourceforge.net/p/usbwriter/wiki/Documentation/ USBwriter] utility to write to your USB flash memory.
[https://rufus.ie/ Rufus] is a multi-purpose USB ISO writer. It provides a graphical user interface and does not care if the drive is properly formatted or not.


===== Using win32diskimager =====
Simply select the Arch Linux ISO, the USB drive you want to create the bootable Arch Linux onto and click ''START''.


[https://sourceforge.net/projects/win32diskimager/ win32diskimager] is another graphical USB iso writing tool for Windows. Simply select your iso image and the target USB drive letter (you may have to format it first to assign it a drive letter), and click Write.  
{{Note|If the USB drive does not boot properly using the default ISO Image mode, '''DD Image mode''' should be used instead. To switch this mode on, select ''GPT'' from the ''Partition scheme'' drop-down menu. After clicking ''START'' you will get the mode selection dialog, select ''DD Image mode''.}}


===== Using Cygwin =====
{{Tip|To add [https://github.com/pbatard/rufus/issues/691 an additional partition for persistent storage] use the slider to choose the persistent partition's size. When using the persistent partition feature, make sure to select ''MBR'' in the ''Partition scheme'' drop-down menu and ''BIOS or UEFI'' in ''Target System'', otherwise the drive will not be usable for both BIOS and UEFI booting.}}


Make sure your [http://www.cygwin.com/ Cygwin] installation contains the {{ic|dd}} package.
==== Using Cygwin ====


{{Tip|If you do not want to install Cygwin, you can download {{ic|dd}} for Windows from [http://www.chrysocome.net/dd here]. See the next section for more information.}}
Make sure your [https://www.cygwin.com/ Cygwin] installation contains the {{ic|dd}} package.


Place your image file in your home directory:
Place your image file in your home directory:


  C:\cygwin\home\John\
  C:\cygwin\home\''User''\


Run cygwin as administrator (required for cygwin to access hardware). To write to your USB drive use the following command:
Run cygwin as administrator (required for cygwin to access hardware). To write to your USB drive use the following command:


  dd if=image.iso of=\\.\'''x''': bs=4M
  dd if=archlinux-''version''-x86_64.iso of=\\.\''x'': bs=4M


where image.iso is the path to the iso image file within the {{ic|cygwin}} directory and {{ic|\\.\'''x''':}} is your USB flash drive where {{ic|'''x'''}} is the windows designated letter, e.g. {{ic|\\.\d:}}.
where {{ic|archlinux-''version''-x86_64.iso}} is the path to the iso image file within the {{ic|cygwin}} directory and {{ic|\\.\''x'':}} is your USB flash drive where {{ic|''x''}} is the windows designated letter, e.g. {{ic|\\.\d:}}.


On Cygwin 6.0, find out the correct partition with:
On Cygwin 6.0, find out the correct partition with:
Line 78: Line 133:
and write the ISO image with the information from the output. Example:
and write the ISO image with the information from the output. Example:


{{Warning|This will irrevocably delete all files on your USB flash drive, so make sure you do not have any important files on the flash drive before doing this.}}
dd if=archlinux-''version''-x86_64.iso of=/dev/sdb bs=4M


dd if=image.iso of=/dev/sdb bs=4M
==== Using dd for Windows ====


===== dd for Windows =====
A GPL licensed dd version for Windows is available at http://www.chrysocome.net/dd. The advantage of this over Cygwin is a smaller download. Use it as shown in instructions for Cygwin above.


{{Note|Some users have an "isolinux.bin missing or corrupt" problem when booting the media with this method.}}
To begin, download the latest version of dd for Windows. Once downloaded, extract the archive's contents into the {{ic|Downloads}} directory or elsewhere.


A GPL licensed dd version for Windows is available at http://www.chrysocome.net/dd. The advantage of this over Cygwin is a smaller download. Use it as shown in instructions for Cygwin above.
Now, launch your ''Command Prompt'' as an administrator. Next, change directory ({{ic|cd}}) into the {{ic|Downloads}} directory.
 
If your Arch Linux ISO is elsewhere you may need to state the full path, for convenience you may wish to put the Arch Linux ISO into the same folder as the ''dd'' executable. The basic format of the command will look like this.
 
# dd if=archlinux-''version''-x86_64.iso od=\\.\''x'': bs=4M


To begin, download the latest version of dd for Windows. Once downloaded, extract the archive's contents into Downloads or elsewhere.
{{Note|The Windows drive letters are linked to a partition. To allow selecting the entire disk, ''dd for Windows'' provides the {{ic|od}} parameter, which is used in the commands above. Note however that this parameter is specific to ''dd for Windows'' and cannot be found in other implementations of ''dd''.}}


Now, launch your {{ic|command prompt}} as an administrator. Next, change directory ({{ic|cd}}) into the Downloads directory.
==== Using flashnul ====


If your Arch Linux ISO is elsewhere you may need to state the full path, for convenience you may wish to put the Arch Linux ISO into the same folder as the dd executable. The basic format of the command will look like this.
[https://github.com/amarao/flashnul/blob/master/README.md flashnul] is an utility to verify the functionality and maintenance of Flash-Memory (USB-Flash, IDE-Flash, SecureDigital, MMC, MemoryStick, SmartMedia, XD, CompactFlash etc).


# dd if=''archlinux-2015-XX-YY-dual.iso'' od=\\.\''x'': bs=4M
From a command prompt, invoke flashnul with {{ic|-p}}, and determine which device index is your USB drive, e.g.:


{{Note|The Windows drive letters are linked to a partition. To allow selecting the entire disk, ''dd for Windows'' provides the {{ic|od}} parameter, which is used in the commands above. Note however that this parameter is specific to ''dd for Windows'' and cannot be found in other implementations of ''dd''.}}
{{hc|C:\>flashnul -p|
Avaible physical drives:
Avaible logical disks:
C:\
D:\
E:\
}}


{{Warning|Because the {{ic|od}} is used, all partitions on the selected disk will be destroyed. Be absolutely sure that you are directing dd to the correct drive before executing.}}
When you have determined which device is the correct one, you can write the image to your drive, by invoking flashnul with the device index, {{ic|-L}}, and the path to your image, e.g:


Simply replace the various null spots (indicated by an "x") with the correct date and correct drive letter. Here is a complete example.
C:\>flashnul '''E:''' -L ''path\to\''archlinux-''version''-x86_64.iso


# dd if=ISOs\archlinux-2015.01.01-dual.iso od=\\.\d: bs=4M
As long as you are really sure you want to write the data, type yes, then wait a bit for it to write. If you get an access denied error, close any Explorer windows you have open.


{{Accuracy|The following note may be invalid, the [http://www.chrysocome.net/dd upstream documentation] does not mention anything related to ''PhysicalDrive''.}}
{{Note|Open the command prompt as administrator, or else flashnul will fail to open the stick as a block device and will only be able to write via the drive handle windows provides.}}


{{Note|Alternatively, replace the drive letter with {{ic|\\.\PhysicalDrive''X''}}, where {{ic|''X''}} is the physical drive number (starts from 0). Example:
=== In macOS ===
{{bc|1=# dd if=ISOs\archlinux-2015.01.01-dual.iso of=\\.\PhysicalDrive1 bs=4M}}
You can find out the physical drive number by typing {{ic|wmic diskdrive list brief}} at the command prompt or with {{ic|dd --list}}
Any Explorer window must be closed or dd will report an error.}}


==== In macOS ====
==== Using macOS dd ====


First, you need to identify the USB device. Open {{ic|/Applications/Utilities/Terminal}} and list all storage devices with the command:
First, you need to identify the USB device. Open {{ic|/Applications/Utilities/Terminal}} and list all storage devices with the command:
Line 117: Line 179:
  $ diskutil list
  $ diskutil list


Your USB device will appear as something like {{ic|/dev/disk2 (external, physical)}}. Verify that this is the device you want to erase by checking its name and size and then use its identifier for the commands below instead of /dev/diskX.
Your USB device will appear as something like {{ic|/dev/disk2 (external, physical)}}. Verify that this is the device you want to erase by checking its name and size and then use its identifier for the commands below instead of {{ic|/dev/disk''X''}}.
 
A USB device is normally auto-mounted in macOS, and you have to unmount (not eject) it before block-writing to it with {{ic|dd}}. In ''Terminal'', do:
 
$ diskutil unmountDisk /dev/disk''X''
 
Now copy the ISO image file to the device:
 
{{Note|
* BSD-derived {{ic|dd}}, which includes macOS's default {{ic|dd}}, uses lower-case {{ic|m}} suffix. This differs from GNU {{ic|dd}}, used elsewhere in this article.
* The {{ic|r}} before {{ic|disk}} is for raw mode which makes the transfer much faster.
* In newer versions of macOS, the dd command supports {{ic|status{{=}}progress}} and can be used to show progress. It's also possible to view progress manually as described below.
}}
 
# dd if=''path/to''/archlinux-''version''-x86_64.iso of=/dev/'''r'''disk''X'' bs=1m
 
This command will run silently. To view progress, send SIGINFO by pressing {{ic|Ctrl+t}}. Note {{ic|disk''X''}} here should not include the {{ic|s1}} suffix, or else the USB device will only be bootable in UEFI mode and not legacy. After completion, macOS may complain that ''The disk you inserted was not readable by this computer''. Select ''Ignore''. The USB device will be bootable.
 
==== Using USBImager ====
 
[https://gitlab.com/bztsrc/usbimager/ USBImager] is a multiplatform graphical application that writes and verifies compressed disk images to USB drives, and creates backups.
 
=== In Android ===


A USB device is normally auto-mounted in Mac OS, and you have to unmount (not eject) it before block-writing to it with {{ic|dd}}. In Terminal, do:
==== Using EtchDroid ====


$ diskutil unmountDisk /dev/diskX
[https://etchdroid.depau.eu/ EtchDroid] is a OS image flasher for Android. It works without root permissions since Android 5. Check the upstream [https://github.com/EtchDroid/EtchDroid/issues/ GitHub] if you have issue.


Now copy the ISO image file to the device. The {{ic|dd}} command is similar to its Linux counterpart, but notice the 'r' before 'disk' for raw mode which makes the transfer much faster:
To create an Arch Linux installer, download the ISO image file on your Android device. Plug the USB drive to your device, using a USB-OTG adapter if needed. Open EtchDroid, select ''Flash raw image'', select your Arch ISO, then select your USB drive. Grant the USB API permission and confirm.


$ sudo dd if=path/to/arch.iso of=/dev/'''r'''diskX bs=1m
Keep your phone on a table while it is writing the image: a lot of USB-OTG adapters are a bit wobbly and you might unplug it by mistake.


After completion, Mac OS may complain that "The disk you inserted was not readable by this computer". Select 'Ignore'. The USB device will be bootable.
== Using manual formatting ==


=== Using manual formatting===
=== BIOS and UEFI ===


==== In GNU/Linux ====
==== In GNU/Linux ====
Line 135: Line 219:
This method is more complicated than writing the image directly with {{ic|dd}}, but it does keep the flash drive usable for data storage (that is, the ISO is installed in a specific partition within the already [[Partitioning|partitioned device]] without altering other partitions).
This method is more complicated than writing the image directly with {{ic|dd}}, but it does keep the flash drive usable for data storage (that is, the ISO is installed in a specific partition within the already [[Partitioning|partitioned device]] without altering other partitions).


{{Note|Here, we will denote the targeted partition as {{ic|/dev/sd'''Xn'''}}. In any of the following commands, adjust '''X''' and '''n''' according to your system.}}
{{Note|Here, we will denote the targeted partition as {{ic|/dev/disk/by-id/usb-''My_flash_drive''-part''n''}}. In any of the following commands, adjust {{ic|''My_flash_drive''}} and {{ic|''n''}} according to your system.}}


* Make sure that the latest {{Pkg|syslinux}} package (version 6.02 or newer) is installed on the system.  
* If not done yet, create a [[partition table]] on {{ic|/dev/disk/by-id/usb-''My_flash_drive''}}.
* If not done yet, create a partition on the device. The partition {{ic|/dev/disk/by-id/usb-''My_flash_drive''-part''n''}} must be formatted to [[FAT32]].
* Mount the FAT32 file system located in the USB flash device and [[extract]] the contents of the ISO image to it. For example:


* If not done yet, create the partition table and/or partition on the device before continuing. The partition {{ic|/dev/sd'''Xn'''}} must be formatted to FAT32.
# mount /dev/disk/by-id/usb-''My_flash_drive''-part''n'' /mnt
# bsdtar -x -f archlinux-''version''-x86_64.iso -C /mnt


* Mount the ISO image, mount the FAT32 filesystem located in the USB flash device, and copy the contents of the ISO image to it. Then unmount the ISO image, but keep the FAT32 partition mounted (this will be used in subsequent steps). Eg:
BIOS booting requires specifying the volume on which the files reside. By default the UUID {{ic|''YYYY-mm-dd-HH-MM-SS''-00}} (with the appropriate release date and time in UTC) is used. Replace the {{ic|archisodevice{{=}}}} parameter in {{ic|/mnt/boot/syslinux/archiso_sys-linux.cfg}} with a [[Persistent block device naming|persistent device identifier]] for your device. E.g. {{ic|1=archisodevice=UUID=''YOUR-UUID''}}.
# mkdir -p /mnt/{iso,usb}
# mount -o loop archlinux-2016.04.01-dual.iso /mnt/iso
# mount /dev/sd'''Xn''' /mnt/usb
# cp -a /mnt/iso/* /mnt/usb
# sync
# umount /mnt/iso


* {{Note|The following step is not required when using [[Archboot]] instead of [[Archiso]].}} To boot either a label or an [[UUID]] to select the partition to boot from is required. By default the label {{ic|ARCH_2017'''XX'''}} (with the appropriate release month) is used. Thus, the partition’s label has to be set accordingly, for example using ''gparted''. Alternatively, you can change this behaviour by altering the lines ending by {{ic|1=archisolabel=ARCH_2017'''XX'''}} in files ''/mnt/usb/arch/boot/syslinux/archiso_sys32.cfg'' and ''archiso_sys64.cfg'', as well as ''/mnt/usb/loader/entries/archiso-x86_64.conf'' or similar for a 32-bit ISO (the last being useful only, if you want to boot the USB flash device from an EFI system). To use an UUID instead, replace those portions of lines with {{ic|1=archiso''device''=/dev/disk/by-uuid/'''YOUR-UUID'''}}. The UUID can be retrieved with {{ic|1=blkid -o value -s UUID /dev/sd'''Xn'''}}.
{{Note|Wrong {{ic|archisolabel}} or {{ic|archisodevice}} will prevent booting from the created medium.}}


{{Warning|Mismatching labels or wrong UUID prevents booting from the created medium.}}
[[Syslinux]] files for BIOS systems are already copied to {{ic|/mnt/boot/syslinux/}}. [[Unmount]] the FAT file system, [[install]] the {{Pkg|syslinux}} and {{Pkg|mtools}} packages and run the following commands to make the partition bootable:


* Syslinux is already preinstalled in ''/mnt/usb/arch/boot/syslinux''. Install it completely to that folder by following [[Syslinux#Manual install]]. Instructions are reproduced here for convenience.
# umount /mnt
** Overwrite the existing Syslinux modules ({{ic|*.c32}} files) present in the USB (from the ISO) with the ones from the syslinux package (found in ''/usr/lib/syslinux/bios''). This is necessary to avoid boot failure because of a possible version mismatch.
# syslinux --directory boot/syslinux --install /dev/disk/by-id/usb-''My_flash_drive''-part''n''
  # cp /usr/lib/syslinux/bios/*.c32 /mnt/usb/arch/boot/syslinux
  # dd bs=440 count=1 conv=notrunc if=/usr/lib/syslinux/bios/mbr.bin of=/dev/disk/by-id/usb-''My_flash_drive''
** Run:
# extlinux --install /mnt/usb/arch/boot/syslinux
** Unmount the partition ({{ic|umount /mnt/usb}}) and install the MBR or GPT partition table to the USB device as described in the page mentioned.


* Mark the partition as active (or “bootable”).
{{Note|
* Replace {{ic|mbr.bin}} with {{ic|gptmbr.bin}} if {{ic|/dev/disk/by-id/usb-''My_flash_drive''}} has a [[GUID Partition Table]]. See [[Syslinux#Manually]] for details.
* For the [[MBR]] partition table you will need to set the "boot" flag. See [[Syslinux#MBR partition table]] for details.
}}


==== In Windows ====
==== In Windows ====
Line 166: Line 247:
{{Note|
{{Note|
* For manual formatting, do not use any '''Bootable USB Creator utility''' for creating the UEFI bootable USB. For manual formatting, do not use ''dd for Windows'' to dd the ISO to the USB drive either.
* For manual formatting, do not use any '''Bootable USB Creator utility''' for creating the UEFI bootable USB. For manual formatting, do not use ''dd for Windows'' to dd the ISO to the USB drive either.
 
* In the below commands, {{ic|''X'':}} is assumed to be the USB flash drive in Windows.
* In the below commands, '''X:''' is assumed to be the USB flash drive in Windows.
 
* Windows uses backward slash {{ic|\}} as path-separator, so the same is used in the below commands.
* Windows uses backward slash {{ic|\}} as path-separator, so the same is used in the below commands.
* All commands should be run in Windows command prompt '''as administrator'''.
* All commands should be run in Windows command prompt '''as administrator'''.
* {{ic|>}} denotes the Windows command prompt.
* {{ic|>}} denotes the Windows command prompt.
}}
}}


* Partition and format the USB drive using [http://rufus.akeo.ie/ Rufus USB partitioner]. Select partition scheme option as '''MBR for BIOS and UEFI''' and File system as '''FAT32'''. Uncheck "Create a bootable disk using ISO image" and "Create extended label and icon files" options.
* Partition and format the USB drive using [https://rufus.ie/ Rufus USB partitioner]. Select partition scheme option as '''MBR for BIOS and UEFI''' and File system as '''FAT32'''. Uncheck "Create a bootable disk using ISO image" and "Create extended label and icon files" options.
 
* Set the '''Volume Label''' to a value of you choice. This step is required for Official ISO ([[Archiso]]). This step can be also performed using Rufus, during the prior "partition and format" step.
* Change the '''Volume Label''' of the USB flash drive {{ic|X:}} to match the LABEL mentioned in the {{ic|1=archisolabel=}} part in {{ic|<ISO>\loader\entries\archiso-x86_64.conf}}. This step is required for Official ISO ([[Archiso]]) but not required for [[Archboot]]. This step can be also performed using Rufus, during the prior "partition and format" step.
* Extract the ISO (similar to extracting ZIP archive) to the USB flash drive using [https://www.7-zip.org/ 7-Zip].
 
* Edit {{ic|''X'':\boot\syslinux\archiso_sys-linux.cfg}} and replace all instances of {{ic|1=archisodevice=UUID=''YYYY-mm-dd-HH-MM-SS''-00}} with {{ic|1=archisodevice=LABEl=''YOUR_LABEL''}} where {{ic|''YOUR_LABEL''}} is the volume label you set previously.
* Extract the ISO (similar to extracting ZIP archive) to the USB flash drive (using [http://7-zip.org/ 7-Zip].  
* Download official Syslinux 6.xx binaries (zip file) from https://www.kernel.org/pub/linux/utils/boot/syslinux/ and extract it. The version of Syslinux should be the same version used in the ISO image.
 
* Download official Syslinux 6.xx binaries (zip file) from https://www.kernel.org/pub/linux/utils/boot/syslinux/ and extract it. The version of Syslinux should be the same version used in the ISO image.


* Run the following command (in Windows cmd prompt, as admin):
* Run the following command (in Windows cmd prompt, as admin):
{{Note|Use {{ic|X:\boot\syslinux\}} for Archboot iso.}}


  > cd bios\
  > cd bios\
  > for /r %Y in (*.c32) do copy "%Y" "X:\arch\boot\syslinux\" /y
  > for /r %Y in (*.c32) do copy "%Y" "''X'':\boot\syslinux\" /y
  > copy mbr\*.bin X:\arch\boot\syslinux\ /y
  > copy mbr\*.bin ''X'':\boot\syslinux\ /y


* Install Syslinux to the USB by running (use {{ic|win64\syslinux64.exe}} for x64 Windows):
* Install Syslinux to the USB by running (use {{ic|win64\syslinux64.exe}} for x64 Windows):
{{Note|Use {{ic|-d /boot/syslinux}} for Archboot iso.}}


  > cd bios\
  > cd bios\
  > win32\syslinux.exe -d /arch/boot/syslinux -i -a -m X:
  > win32\syslinux.exe -d /boot/syslinux -i -a -m ''X'':


{{Note|
{{Note|
* The above step installs Syslinux's {{ic|ldlinux.sys}} to the VBR of the USB partition, sets the partition as "active/boot" in the MBR partition table and writes the MBR boot code to the 1st 440-byte boot code region of the USB.
* Only copying the files will result in an un-bootable device: this last command installs Syslinux's files to the VBR of the USB partition, sets the partition as "active/boot" in the MBR partition table and writes the MBR boot code to the USB device.
 
* The {{ic|-d}} switch expects a path with forward slash path-separator like in *unix systems.
* The {{ic|-d}} switch expects a path with forward slash path-separator like in *unix systems.
}}
}}


== Other Methods for BIOS systems ==
=== BIOS only ===


=== In GNU/Linux ===
==== In GNU/Linux ====


==== Using a multiboot USB drive ====
===== Making a USB-ZIP drive =====
This allows booting multiple ISOs from a single USB device, including the archiso. Updating an existing USB drive to a more recent ISO is simpler than for most other methods. See [[Multiboot USB drive]].


==== Using GNOME Disk Utility ====
For some old BIOS systems, only booting from USB-ZIP drives is supported. This method allows you to still boot from a USB hard drive.
Linux distributions running GNOME can easily make a live CD through {{Pkg|nautilus}} and {{Pkg|gnome-disk-utility}}. Simply right-click on the .iso file, and select "Open With Disk Image Writer."  When GNOME Disk Utility opens, specify the flash drive from the "Destination" drop-down menu and click "Start Restoring."


==== Making a USB-ZIP drive ====
* [[Install]] {{Pkg|syslinux}} and {{Pkg|mtools}}.
For some old BIOS systems, only booting from USB-ZIP drives is supported. This method allows you to still boot from a USB-HDD drive.
* Find your USB drive with {{ic|ls /dev/disk/by-id/usb-*}}.
{{Warning|This will destroy all information on your USB flash drive!}}
* Type {{ic|mkdiskimage -4 /dev/disk/by-id/usb-''My_flash_drive'' 0 64 32}}. This will take a while.


* Download {{Pkg|syslinux}} and {{Pkg|mtools}} from the official repositories.
From here continue with the manual formatting method. The partition will be {{ic|/dev/disk/by-id/usb-''My_flash_drive''-part4}} due to the way ZIP drives work.
* Find your usb drive with {{ic|lsblk}}.
* Type {{ic|mkdiskimage -4 /dev/sd'''x''' 0 64 32}} (replace x with the letter of your drive). This will take a while.
From here continue with the manual formatting method. The partition will be /dev/sd'''x'''4 due to the way ZIP drives work.


{{Note|Do not format the drive as FAT32 keep it as FAT16.}}
{{Note|Do not format the drive as FAT32; keep it as FAT16.}}


==== Using UNetbootin ====
=== UEFI only ===
UNetbootin can be used on any Linux distribution or Windows to copy your iso to a USB device. However, Unetbootin overwrites syslinux.cfg, so it creates a USB device that does not boot properly. For this reason, '''Unetbootin is not recommended''' -- please use {{ic|dd}} or one of the other methods discussed in this topic.
{{Warning|UNetbootin writes over the default {{ic|syslinux.cfg}}; this must be restored before the USB device will boot properly.}}


Edit {{ic|syslinux.cfg}}:
For UEFI-only booting, it is enough to extract the ISO contents onto a FAT-formatted USB flash drive.


{{hc|sysconfig.cfg|2=
It does not require creating a EFI system partition on the drive as all UEFI will happily boot any FAT volume from USB flash drives. The most compatible setup would be using the MBR partition table with a single active (bootable) primary partition of type {{ic|0c}} "W95 FAT32 (LBA)".[https://lists.gnu.org/archive/html/grub-devel/2019-05/msg00063.html]
default menu.c32
prompt 0
menu title Archlinux Installer
timeout 100


label unetbootindefault
{{Tip|See [[Secure Boot#Sign the official ISO with custom keys]] to understand which files need to be signed if Secure Boot is configured with custom keys.}}
menu label Archlinux_x86_64
kernel /arch/boot/x86_64/vmlinuz
append initrd=/arch/boot/x86_64/archiso.img archisodevice=/dev/sd'''x1''' ../../


label ubnentry0
==== In GNU/Linux ====
menu label Archlinux_i686
kernel /arch/boot/i686/vmlinuz
append initrd=/arch/boot/i686/archiso.img archisodevice=/dev/sd'''x1''' ../../
}}


In {{ic|/dev/sd'''x1'''}} you must replace '''x''' with the first free letter after the last letter in use on the system where you are installing Arch Linux (e.g. if you have two hard drives, use {{ic|c}}.). You can make this change during the first phase of boot by pressing {{ic|Tab}} when the menu is shown.
This method extracts files from the ISO image to a USB flash drive.


=== In Windows ===
# If not done yet, create a [[partition table]] on {{ic|/dev/disk/by-id/usb-''My_flash_drive''}} and a [[partition]] ({{ic|/dev/disk/by-id/usb-''My_flash_drive''-part''n''}}) on the device.
# If not done yet, format the partition to [[FAT32]]: {{bc|# mkfs.fat -F 32 /dev/disk/by-id/usb-''My_flash_drive''-part''n''}}
# [[Mount]] the file system: {{bc|# mount /dev/disk/by-id/usb-''My_flash_drive''-part''n'' /mnt}}
# Extract the ISO image to the mounted file system: {{bc|1=# bsdtar -x -f archlinux-''version''-x86_64.iso -C /mnt}}
# [[Unmount]] the file system.


==== Win32 Disk Imager ====
==== In Windows ====


{{Warning|This will destroy all information on your USB flash drive!}}
This method copies files from the ISO image to a USB flash drive.
First, download the program from [http://sourceforge.net/projects/win32diskimager/ here]. Next, extract the archive and run the executable. Now, select the Arch Linux ISO under the {{ic|Image File}} section and the USB flash device letter (for example, [D:\]) under the {{ic|Device}} section. Finally, click {{ic|Write}} when ready.
{{Note|After installation, you may need to restore the USB flash drive following a process as outlined [[#How to restore the USB drive|here]]{{Broken section link}}.}}


==== USBWriter for Windows ====
# Partition the USB flash drive and format it to FAT32.
# Right click on {{ic|archlinux-''version''-x86_64.iso}} and select ''Mount''.
# Navigate to the newly created DVD drive and copy all files and folders to the USB flash drive.
# When done copying, right click on the DVD drive and select ''Eject''.
# Eject the USB flash drive.


Download the program from http://sourceforge.net/projects/usbwriter/ and run it. Select the arch image file, the target USB stick, and click on the {{ic|write}} button. Now you should be able to boot from the usb stick and install Arch Linux from it.
==== In macOS ====


==== The Flashnul way ====
Neither ''DiskImageMounter'' nor ''Disk Utility'' can mount isohybrid ISOs, but since macOS ships with ''libarchive'', the ISO can simply be extracted onto the flash drive using ''bsdtar''.


[https://translate.google.com/translate?hl=&sl=ru&tl=en&u=http%3A%2F%2Fshounen.ru%2Fsoft%2Fflashnul%2Freadme.rus.html&sandbox=1 flashnul] is an utility to verify the functionality and maintenance of Flash-Memory (USB-Flash, IDE-Flash, SecureDigital, MMC, MemoryStick, SmartMedia, XD, CompactFlash etc).
# If not done yet, partition the USB flash drive and format the partition to FAT32 using ''Disk Utility''.
# Mount the volume.
# Open the ''Terminal'' application and use ''bsdtar'' to extract the ISO image to the mounted file system: {{bc|$ bsdtar -x -f archlinux-''version''-x86_64.iso -C /Volumes/''your-flash-drive''}}
# When done, unmount and eject the USB flash drive.


From a command prompt, invoke flashnul with {{ic|-p}}, and determine which device index is your USB drive, e.g.:
== Using a multiboot USB drive ==


{{hc|C:\>flashnul -p|
{{Merge|Multiboot USB drive|For [[Multiboot USB drive#Using Syslinux and memdisk]], this is the same method, only Syslinux is installed from Windows. This whole section should be merged there, since [[Ventoy]] is already mentioned over there too.}}
Avaible physical drives:
Avaible logical disks:
C:\
D:\
E:\
}}


When you have determined which device is the correct one, you can write the image to your drive, by invoking flashnul with the device index, {{ic|-L}}, and the path to your image, e.g:
This allows booting multiple ISOs from a single USB device, including the archiso. Updating an existing USB drive to a more recent ISO is simpler than for most other methods. See [[Multiboot USB drive]].


C:\>flashnul '''E:''' -L ''path\to\arch.iso''
=== Using ventoy ===


As long as you are really sure you want to write the data, type yes, then wait a bit for it to write. If you get an access denied error, close any Explorer windows you have open.
[[Ventoy]] is an open source tool to create bootable USB drive for ISO/WIM/IMG/VHD(x)/EFI files. With ventoy, you do not need to format the disk over and over, you just need to copy the ISO/WIM/IMG/VHD(x)EFI files to the USB drive and boot them directly. You can copy many files at a time and ventoy will give you a boot menu to select them. It is available as {{AUR|ventoy-bin}}.


If under Vista or Win7, you should open the console as administrator, or else flashnul will fail to open the stick as a block device and will only be able to write via the drive handle windows provides
=== In Windows ===
 
{{Note|Confirmed that you need to use drive letter as opposed to number. flashnul 1rc1, Windows 7 x64.}}
 
==== Loading the installation media from RAM ====


{{Merge|Multiboot USB drive#Using Syslinux and memdisk|This is the same method, only Syslinux is installed from Windows. Considering that [[multiboot USB drive]] can be used to boot an installation media and it is already linked from the Related articles box at the top, maybe this section should be merged there?}}
==== Loading the installation medium from RAM ====


This method uses [[Syslinux]] and a [[Ramdisk]] ([http://www.syslinux.org/wiki/index.php/MEMDISK MEMDISK]) to load the entire Arch Linux ISO image into RAM. Since this will be running entirely from system memory, you will need to make sure the system you will be installing this on has an adequate amount. A minimum amount of RAM between 500 MB and 1 GB should suffice for a MEMDISK based, Arch Linux install.
This method uses [[Syslinux]] and a [[Ramdisk]] ([https://wiki.syslinux.org/wiki/index.php/MEMDISK MEMDISK]) to load the entire Arch Linux ISO image into RAM. Since this will be running entirely from system memory, you will need to make sure the system you will be installing this on has an adequate amount. A minimum amount of RAM between 500 MB and 1 GB should suffice for a MEMDISK based, Arch Linux install.


For more information on Arch Linux system requirements as well as those for MEMDISK see the [[Installation guide]] and [http://www.etherboot.org/wiki/bootingmemdisk#preliminaries here]. For reference, here is the [https://bbs.archlinux.org/viewtopic.php?id=135266 preceding forum thread].
For more information on Arch Linux system requirements as well as those for MEMDISK see the [[Installation guide]] and [http://www.etherboot.org/wiki/bootingmemdisk#preliminaries here]. For reference, here is the [https://bbs.archlinux.org/viewtopic.php?id=135266 preceding forum thread].
Line 300: Line 351:


Begin by formatting the USB flash drive as '''FAT32'''. Then create the following folders on the newly formatted drive.
Begin by formatting the USB flash drive as '''FAT32'''. Then create the following folders on the newly formatted drive.
* {{ic|Boot}}
* {{ic|Boot}}
** {{ic|Boot/ISOs}}
** {{ic|Boot/ISOs}}
Line 306: Line 358:
===== Copy the needed files to the USB flash drive =====
===== Copy the needed files to the USB flash drive =====


Next copy the ISO that you would like to boot to the {{ic|Boot/ISOs}} folder. After that, extract from the following files from the latest release of {{pkg|syslinux}} from [http://www.kernel.org/pub/linux/utils/boot/syslinux/ here] and copy them into the following folders.
Next copy the ISO that you would like to boot to the {{ic|Boot/ISOs}} folder. After that, extract from the following files from the latest release of {{pkg|syslinux}} from [https://www.kernel.org/pub/linux/utils/boot/syslinux/ here] and copy them into the following folders.
* {{ic|./win32/syslinux.exe}} to the Desktop or Downloads folder on your system.
* {{ic|./win32/syslinux.exe}} to the Desktop or Downloads folder on your system.
* {{ic|./memdisk/memdisk}} to the {{ic|Settings}} folder on your USB flash drive.
* {{ic|./memdisk/memdisk}} to the {{ic|Settings}} folder on your USB flash drive.
Line 313: Line 365:


After copying the needed files, navigate to the USB flash drive, /boot/Settings and create a {{ic|syslinux.cfg}} file.
After copying the needed files, navigate to the USB flash drive, /boot/Settings and create a {{ic|syslinux.cfg}} file.
{{Warning|On the {{ic|INITRD}} line, be sure to use the name of the ISO file that you copied to your {{ic|ISOs}} folder!}}
 
{{Note|On the {{ic|INITRD}} line, be sure to use the name of the ISO file that you copied to your {{ic|ISOs}} folder.}}
 
{{hc|/Boot/Settings/syslinux.cfg|2=
{{hc|/Boot/Settings/syslinux.cfg|2=
DEFAULT arch_iso
DEFAULT arch_iso
Line 320: Line 374:
         MENU LABEL Arch Setup
         MENU LABEL Arch Setup
         LINUX memdisk
         LINUX memdisk
         INITRD /Boot/ISOs/archlinux-2015.01.01-dual.iso
         INITRD /Boot/ISOs/archlinux-''version''-x86_64.iso
         APPEND iso}}
         APPEND iso
For more information on Syslinux see the [[Syslinux|Arch Wiki article]].
}}
 
For more information see the [[Syslinux]] article.


===== Final steps =====
===== Final steps =====


Finally, create a {{ic|*.bat}} file where {{ic|syslinux.exe}} is located and run it ("Run as administrator" if you are on Vista or Windows 7):
Finally, create a {{ic|*.bat}} file where {{ic|syslinux.exe}} is located and run it ("Run as administrator" if you are on Vista or Windows 7):
{{hc|C:\Documents and Settings\username\Desktop\install.bat|
{{hc|C:\Documents and Settings\username\Desktop\install.bat|
@echo off
@echo off
syslinux.exe -m -a -d /Boot/Settings X:}}
syslinux.exe -m -a -d /Boot/Settings X:
}}
 
== Inadvisable methods ==
 
{{Warning|The following methods are discouraged.}}
 
=== Using etcher ===
 
etcher contains analytics and first-party advertising. See [https://github.com/balena-io/etcher/issues/2057], [https://github.com/balena-io/etcher/blob/37769efbeda0abe7993d95e2b2aea2f461edd307/lib/gui/app/pages/main/MainPage.tsx#L151] and [https://github.com/balena-io/etcher/blob/37769efbeda0abe7993d95e2b2aea2f461edd307/docs/MAINTAINERS.md#publishing].
 
=== Using Universal USB Installer ===
 
* The download page contains fake ''Download'' buttons that may contain malware.
* Universal USB Installer does not write the ISO as-is which breaks BIOS booting due to the discrepancy in syslinux versions. See [https://bbs.archlinux.org/viewtopic.php?pid=1344629].
* The Arch Linux installation image's boot loaders expect the ISO contents to reside on volume with the label {{ic|ARCH_''YYYYXX''}}. Universal USB Installer does not update the file system label, nor does it correct the boot loader configuration.
 
=== Using UNetbootin ===
 
* UNetbootin does not write the ISO as-is which breaks BIOS booting due to the discrepancy in syslinux versions.
* The Arch Linux installation image's boot loaders expect the ISO contents to reside on volume with the label {{ic|ARCH_''YYYYXX''}}. UNetbootin does not update the file system label, nor does it correct the boot loader configuration.


== Troubleshooting ==
== Troubleshooting ==


* For the [[#Loading the installation media from RAM|MEMDISK Method]], if you get the famous "30 seconds" error trying to boot the i686 version, press the {{ic|Tab}} key over the {{ic|Boot Arch Linux (i686)}} entry and add {{ic|vmalloc&#61;448M}} at the end. For reference: ''If your image is bigger than 128MiB and you have a 32-bit OS, then you have to increase the maximum memory usage of vmalloc''. [http://www.syslinux.org/wiki/index.php/MEMDISK#-_memdiskfind_in_combination_with_phram_and_mtdblock]
=== Device does not show up ===
 
If you get the {{ic|device did not show up after 30 seconds}} error due to {{ic|/dev/disk/by-label/ARCH_''YYYYMM''}} not mounting, try renaming your USB medium to {{ic|ARCH_''YYYYMM''}} so Arch can find it. (e.g. For {{ic|archlinux-2021.02.01-x86_64.iso}}, use {{ic|ARCH_202102}}).
 
=== Failed to set up loop devices: No such file or directory ===
 
If you get {{ic|losetup: /run/archiso/bootmnt/arch/x86_64/airootfs.sfs: failed to set up loop devices: No such file or directory}}, try using a USB 2.0 port. For example, some USB 3.0 ports through USB hubs do not work.
 
=== Other errors ===


* If you get the "30 seconds" error due to the {{ic|/dev/disk/by-label/ARCH_XXXXYY}} not mounting, try renaming your USB media to {{ic|ARCH_XXXXYY}} (e.g. {{ic|ARCH_201501}}).
If you get other errors, try using another USB device. There are multiple scenarios in which it solved all issues.


== See Also ==
== See also ==


* [https://wiki.gentoo.org/wiki/LiveUSB/HOWTO Gentoo wiki - LiveUSB/HOWTO]
* [[Gentoo:LiveUSB/Guide]]
* [https://fedoraproject.org/wiki/How_to_create_and_use_Live_USB Fedora wiki - How to create and use Live USB]
* [[Fedora:How to create and use Live USB]]
* [http://en.opensuse.org/SDB:Live_USB_stick openSUSE wiki - SDB:Live USB stick]
* [https://en.opensuse.org/SDB:Live_USB_stick openSUSE wiki - SDB:Live USB stick]

Latest revision as of 09:11, 16 March 2024

This page discusses various multi-platform methods on how to create an Arch Linux Installer USB drive (also referred to as "flash drive", "USB stick", "USB key", etc) for booting in BIOS and UEFI systems. The result will be a live USB system that can be used for installing Arch Linux, system maintenance or for recovery purposes, and that, because of using Overlayfs for /, will discard all changes once the computer shuts down.

If you would like to run a full install of Arch Linux from a USB drive (i.e. with persistent settings), see Install Arch Linux on a removable medium. If you would like to use your bootable Arch Linux USB stick as a rescue USB, see chroot.

Before following any of these steps, download the ISO from https://archlinux.org/download/ and verify its integrity.

Using the ISO as is (BIOS and UEFI)

Warning: This will irrevocably delete all data on your USB flash drive, so make sure you do not have any important files on the flash drive before doing this.
Note: If, instead of a USB flash drive or an SD card, you want to write the ISO to a hard disk drive or a solid state drive, make sure the drive's logical sector size is not larger than 2048 bytes (the ISO 9660 sector size) and aligns to it. This means the ISO cannot be written to a 4Kn Advanced Format drive using this method.

In GNU/Linux

Using basic command line utilities

This method is recommended due to its simplicity and universal availability, since these tools are part of coreutils (pulled in by the base meta package).

Find out the name of your USB drive with ls -l /dev/disk/by-id/usb-* and check with lsblk to make sure that it is not mounted.

Run one of the following commands, replacing /dev/disk/by-id/usb-My_flash_drive with your drive, e.g. /dev/disk/by-id/usb-Kingston_DataTraveler_2.0_408D5C1654FDB471E98BED5C-0:0. (Do not append a partition number, so do not use something like /dev/disk/by-id/usb-Kingston_DataTraveler_2.0_408D5C1654FDB471E98BED5C-0:0-part1 or /dev/sdb1):

  • using cat(1):
    # cat path/to/archlinux-version-x86_64.iso > /dev/disk/by-id/usb-My_flash_drive
  • using cp(1):
    # cp path/to/archlinux-version-x86_64.iso /dev/disk/by-id/usb-My_flash_drive
  • using dd:
    # dd bs=4M if=path/to/archlinux-version-x86_64.iso of=/dev/disk/by-id/usb-My_flash_drive conv=fsync oflag=direct status=progress
  • using tee:
    # tee < path/to/archlinux-version-x86_64.iso > /dev/disk/by-id/usb-My_flash_drive
  • using pv:
    # pv path/to/archlinux-version-x86_64.iso > /dev/disk/by-id/usb-My_flash_drive

See [1] and [2] for a comparison and perspective on the use of those tools and why dd may be the least adapted one.

Tip:
  • Executing sync with root privileges after the respective command ensures buffers are fully written to the device before you remove it.
  • If the UEFI version of the USB's Arch ISO hangs or is unable to load, try repeating the medium creation process on the same USB drive one or more times. If this does not work, you may also try updating your motherboard's firmware.
Note: To restore the USB drive as an empty, usable storage device after using the Arch ISO image, the ISO 9660 filesystem signature needs to be removed by running wipefs --all /dev/disk/by-id/usb-My_flash_drive as root, before repartitioning and reformatting the USB drive.

Using KDE ISO Image Writer

KDE ISO Image Writer can be downloaded via isoimagewriter. It can auto-detect the USB-drive and you need to manually select a ISO file. It is recommended to use .sig file to signature but it can be skipped by clicking "create".

Using GNOME Disk Utility

Linux distributions running GNOME can easily make a live CD through nautilus and gnome-disk-utility. Simply right-click on the .iso file, and select Open With Disk Image Writer. When GNOME Disk Utility opens, specify the flash drive from the Destination drop-down menu and click Start Restoring.

Using MultiWriter

gnome-multi-writer is a simple GTK3 based graphical tool to write an ISO file to one or multiple USB devices at once.

Using Kindd

Kindd is a Qt based graphical frontend for dd. It is available as kinddAUR.

Using Popsicle

Popsicle is a tool made for flashing ISO files to multiple USB devices in parallel by the PopOS development team. It is written in Rust and uses GTK. It is available as popsicleAUR.

Using SUSE Studio ImageWriter

SUSE Studio ImageWriter is a Qt based tool made by the OpenSUSE development team. It is available as imagewriterAUR.

Using xorriso-dd-target

xorriso-dd-target (from libisoburn) is a shell script which attempts to reduce the risk of overwriting the wrong storage device. Its safest mode is named -plug_test. For example, to use it as a regular user who can elevate to root using sudo:

$ xorriso-dd-target -with_sudo -plug_test -DO_WRITE -image_file archlinux-version-x86_64.iso

See xorriso-dd-target(1) for details.

Using USBImager

USBImager is a multiplatform graphical application that writes and verifies compressed disk images to USB drives, and creates backups. It is available as usbimagerAUR.

In Windows

Using KDE ISO Image Writer

KDE ISO Image Writer can be downloaded as .exe file at isoimagewriter. It can auto-detect the USB-drive and you need to manually select a ISO file. It is recommended to use .sig file to signature but it can be skipped by clicking "create".

Using win32diskimager

win32diskimager is another graphical tool for writing images to USB sticks or SD/CF cards from Windows. Select your ISO image and the target USB drive letter (you may have to format it first to assign it a drive letter), and click Write.

Using USBwriter

This method does not require any workaround and is as straightforward as dd under Linux. Just download the Arch Linux ISO, and with local administrator rights use the USBwriter utility to write to your USB flash memory.

Using USBImager

USBImager is a multiplatform graphical application that writes and verifies compressed disk images to USB drives, and creates backups.

Using Rufus

Rufus is a multi-purpose USB ISO writer. It provides a graphical user interface and does not care if the drive is properly formatted or not.

Simply select the Arch Linux ISO, the USB drive you want to create the bootable Arch Linux onto and click START.

Note: If the USB drive does not boot properly using the default ISO Image mode, DD Image mode should be used instead. To switch this mode on, select GPT from the Partition scheme drop-down menu. After clicking START you will get the mode selection dialog, select DD Image mode.
Tip: To add an additional partition for persistent storage use the slider to choose the persistent partition's size. When using the persistent partition feature, make sure to select MBR in the Partition scheme drop-down menu and BIOS or UEFI in Target System, otherwise the drive will not be usable for both BIOS and UEFI booting.

Using Cygwin

Make sure your Cygwin installation contains the dd package.

Place your image file in your home directory:

C:\cygwin\home\User\

Run cygwin as administrator (required for cygwin to access hardware). To write to your USB drive use the following command:

dd if=archlinux-version-x86_64.iso of=\\.\x: bs=4M

where archlinux-version-x86_64.iso is the path to the iso image file within the cygwin directory and \\.\x: is your USB flash drive where x is the windows designated letter, e.g. \\.\d:.

On Cygwin 6.0, find out the correct partition with:

cat /proc/partitions

and write the ISO image with the information from the output. Example:

dd if=archlinux-version-x86_64.iso of=/dev/sdb bs=4M

Using dd for Windows

A GPL licensed dd version for Windows is available at http://www.chrysocome.net/dd. The advantage of this over Cygwin is a smaller download. Use it as shown in instructions for Cygwin above.

To begin, download the latest version of dd for Windows. Once downloaded, extract the archive's contents into the Downloads directory or elsewhere.

Now, launch your Command Prompt as an administrator. Next, change directory (cd) into the Downloads directory.

If your Arch Linux ISO is elsewhere you may need to state the full path, for convenience you may wish to put the Arch Linux ISO into the same folder as the dd executable. The basic format of the command will look like this.

# dd if=archlinux-version-x86_64.iso od=\\.\x: bs=4M
Note: The Windows drive letters are linked to a partition. To allow selecting the entire disk, dd for Windows provides the od parameter, which is used in the commands above. Note however that this parameter is specific to dd for Windows and cannot be found in other implementations of dd.

Using flashnul

flashnul is an utility to verify the functionality and maintenance of Flash-Memory (USB-Flash, IDE-Flash, SecureDigital, MMC, MemoryStick, SmartMedia, XD, CompactFlash etc).

From a command prompt, invoke flashnul with -p, and determine which device index is your USB drive, e.g.:

C:\>flashnul -p
Avaible physical drives:
Avaible logical disks:
C:\
D:\
E:\

When you have determined which device is the correct one, you can write the image to your drive, by invoking flashnul with the device index, -L, and the path to your image, e.g:

C:\>flashnul E: -L path\to\archlinux-version-x86_64.iso

As long as you are really sure you want to write the data, type yes, then wait a bit for it to write. If you get an access denied error, close any Explorer windows you have open.

Note: Open the command prompt as administrator, or else flashnul will fail to open the stick as a block device and will only be able to write via the drive handle windows provides.

In macOS

Using macOS dd

First, you need to identify the USB device. Open /Applications/Utilities/Terminal and list all storage devices with the command:

$ diskutil list

Your USB device will appear as something like /dev/disk2 (external, physical). Verify that this is the device you want to erase by checking its name and size and then use its identifier for the commands below instead of /dev/diskX.

A USB device is normally auto-mounted in macOS, and you have to unmount (not eject) it before block-writing to it with dd. In Terminal, do:

$ diskutil unmountDisk /dev/diskX

Now copy the ISO image file to the device:

Note:
  • BSD-derived dd, which includes macOS's default dd, uses lower-case m suffix. This differs from GNU dd, used elsewhere in this article.
  • The r before disk is for raw mode which makes the transfer much faster.
  • In newer versions of macOS, the dd command supports status=progress and can be used to show progress. It's also possible to view progress manually as described below.
# dd if=path/to/archlinux-version-x86_64.iso of=/dev/rdiskX bs=1m

This command will run silently. To view progress, send SIGINFO by pressing Ctrl+t. Note diskX here should not include the s1 suffix, or else the USB device will only be bootable in UEFI mode and not legacy. After completion, macOS may complain that The disk you inserted was not readable by this computer. Select Ignore. The USB device will be bootable.

Using USBImager

USBImager is a multiplatform graphical application that writes and verifies compressed disk images to USB drives, and creates backups.

In Android

Using EtchDroid

EtchDroid is a OS image flasher for Android. It works without root permissions since Android 5. Check the upstream GitHub if you have issue.

To create an Arch Linux installer, download the ISO image file on your Android device. Plug the USB drive to your device, using a USB-OTG adapter if needed. Open EtchDroid, select Flash raw image, select your Arch ISO, then select your USB drive. Grant the USB API permission and confirm.

Keep your phone on a table while it is writing the image: a lot of USB-OTG adapters are a bit wobbly and you might unplug it by mistake.

Using manual formatting

BIOS and UEFI

In GNU/Linux

This method is more complicated than writing the image directly with dd, but it does keep the flash drive usable for data storage (that is, the ISO is installed in a specific partition within the already partitioned device without altering other partitions).

Note: Here, we will denote the targeted partition as /dev/disk/by-id/usb-My_flash_drive-partn. In any of the following commands, adjust My_flash_drive and n according to your system.
  • If not done yet, create a partition table on /dev/disk/by-id/usb-My_flash_drive.
  • If not done yet, create a partition on the device. The partition /dev/disk/by-id/usb-My_flash_drive-partn must be formatted to FAT32.
  • Mount the FAT32 file system located in the USB flash device and extract the contents of the ISO image to it. For example:
# mount /dev/disk/by-id/usb-My_flash_drive-partn /mnt
# bsdtar -x -f archlinux-version-x86_64.iso -C /mnt

BIOS booting requires specifying the volume on which the files reside. By default the UUID YYYY-mm-dd-HH-MM-SS-00 (with the appropriate release date and time in UTC) is used. Replace the archisodevice= parameter in /mnt/boot/syslinux/archiso_sys-linux.cfg with a persistent device identifier for your device. E.g. archisodevice=UUID=YOUR-UUID.

Note: Wrong archisolabel or archisodevice will prevent booting from the created medium.

Syslinux files for BIOS systems are already copied to /mnt/boot/syslinux/. Unmount the FAT file system, install the syslinux and mtools packages and run the following commands to make the partition bootable:

# umount /mnt
# syslinux --directory boot/syslinux --install /dev/disk/by-id/usb-My_flash_drive-partn
# dd bs=440 count=1 conv=notrunc if=/usr/lib/syslinux/bios/mbr.bin of=/dev/disk/by-id/usb-My_flash_drive
Note:

In Windows

Note:
  • For manual formatting, do not use any Bootable USB Creator utility for creating the UEFI bootable USB. For manual formatting, do not use dd for Windows to dd the ISO to the USB drive either.
  • In the below commands, X: is assumed to be the USB flash drive in Windows.
  • Windows uses backward slash \ as path-separator, so the same is used in the below commands.
  • All commands should be run in Windows command prompt as administrator.
  • > denotes the Windows command prompt.
  • Partition and format the USB drive using Rufus USB partitioner. Select partition scheme option as MBR for BIOS and UEFI and File system as FAT32. Uncheck "Create a bootable disk using ISO image" and "Create extended label and icon files" options.
  • Set the Volume Label to a value of you choice. This step is required for Official ISO (Archiso). This step can be also performed using Rufus, during the prior "partition and format" step.
  • Extract the ISO (similar to extracting ZIP archive) to the USB flash drive using 7-Zip.
  • Edit X:\boot\syslinux\archiso_sys-linux.cfg and replace all instances of archisodevice=UUID=YYYY-mm-dd-HH-MM-SS-00 with archisodevice=LABEl=YOUR_LABEL where YOUR_LABEL is the volume label you set previously.
  • Download official Syslinux 6.xx binaries (zip file) from https://www.kernel.org/pub/linux/utils/boot/syslinux/ and extract it. The version of Syslinux should be the same version used in the ISO image.
  • Run the following command (in Windows cmd prompt, as admin):
> cd bios\
> for /r %Y in (*.c32) do copy "%Y" "X:\boot\syslinux\" /y
> copy mbr\*.bin X:\boot\syslinux\ /y
  • Install Syslinux to the USB by running (use win64\syslinux64.exe for x64 Windows):
> cd bios\
> win32\syslinux.exe -d /boot/syslinux -i -a -m X:
Note:
  • Only copying the files will result in an un-bootable device: this last command installs Syslinux's files to the VBR of the USB partition, sets the partition as "active/boot" in the MBR partition table and writes the MBR boot code to the USB device.
  • The -d switch expects a path with forward slash path-separator like in *unix systems.

BIOS only

In GNU/Linux

Making a USB-ZIP drive

For some old BIOS systems, only booting from USB-ZIP drives is supported. This method allows you to still boot from a USB hard drive.

  • Install syslinux and mtools.
  • Find your USB drive with ls /dev/disk/by-id/usb-*.
  • Type mkdiskimage -4 /dev/disk/by-id/usb-My_flash_drive 0 64 32. This will take a while.

From here continue with the manual formatting method. The partition will be /dev/disk/by-id/usb-My_flash_drive-part4 due to the way ZIP drives work.

Note: Do not format the drive as FAT32; keep it as FAT16.

UEFI only

For UEFI-only booting, it is enough to extract the ISO contents onto a FAT-formatted USB flash drive.

It does not require creating a EFI system partition on the drive as all UEFI will happily boot any FAT volume from USB flash drives. The most compatible setup would be using the MBR partition table with a single active (bootable) primary partition of type 0c "W95 FAT32 (LBA)".[3]

Tip: See Secure Boot#Sign the official ISO with custom keys to understand which files need to be signed if Secure Boot is configured with custom keys.

In GNU/Linux

This method extracts files from the ISO image to a USB flash drive.

  1. If not done yet, create a partition table on /dev/disk/by-id/usb-My_flash_drive and a partition (/dev/disk/by-id/usb-My_flash_drive-partn) on the device.
  2. If not done yet, format the partition to FAT32:
    # mkfs.fat -F 32 /dev/disk/by-id/usb-My_flash_drive-partn
  3. Mount the file system:
    # mount /dev/disk/by-id/usb-My_flash_drive-partn /mnt
  4. Extract the ISO image to the mounted file system:
    # bsdtar -x -f archlinux-version-x86_64.iso -C /mnt
  5. Unmount the file system.

In Windows

This method copies files from the ISO image to a USB flash drive.

  1. Partition the USB flash drive and format it to FAT32.
  2. Right click on archlinux-version-x86_64.iso and select Mount.
  3. Navigate to the newly created DVD drive and copy all files and folders to the USB flash drive.
  4. When done copying, right click on the DVD drive and select Eject.
  5. Eject the USB flash drive.

In macOS

Neither DiskImageMounter nor Disk Utility can mount isohybrid ISOs, but since macOS ships with libarchive, the ISO can simply be extracted onto the flash drive using bsdtar.

  1. If not done yet, partition the USB flash drive and format the partition to FAT32 using Disk Utility.
  2. Mount the volume.
  3. Open the Terminal application and use bsdtar to extract the ISO image to the mounted file system:
    $ bsdtar -x -f archlinux-version-x86_64.iso -C /Volumes/your-flash-drive
  4. When done, unmount and eject the USB flash drive.

Using a multiboot USB drive

This article or section is a candidate for merging with Multiboot USB drive.

Notes: For Multiboot USB drive#Using Syslinux and memdisk, this is the same method, only Syslinux is installed from Windows. This whole section should be merged there, since Ventoy is already mentioned over there too. (Discuss in Talk:USB flash installation medium)

This allows booting multiple ISOs from a single USB device, including the archiso. Updating an existing USB drive to a more recent ISO is simpler than for most other methods. See Multiboot USB drive.

Using ventoy

Ventoy is an open source tool to create bootable USB drive for ISO/WIM/IMG/VHD(x)/EFI files. With ventoy, you do not need to format the disk over and over, you just need to copy the ISO/WIM/IMG/VHD(x)EFI files to the USB drive and boot them directly. You can copy many files at a time and ventoy will give you a boot menu to select them. It is available as ventoy-binAUR.

In Windows

Loading the installation medium from RAM

This method uses Syslinux and a Ramdisk (MEMDISK) to load the entire Arch Linux ISO image into RAM. Since this will be running entirely from system memory, you will need to make sure the system you will be installing this on has an adequate amount. A minimum amount of RAM between 500 MB and 1 GB should suffice for a MEMDISK based, Arch Linux install.

For more information on Arch Linux system requirements as well as those for MEMDISK see the Installation guide and here. For reference, here is the preceding forum thread.

Tip: Once the installer has completed loading you can simply remove the USB stick and even use it on a different machine to start the process all over again. Utilizing MEMDISK also allows booting and installing Arch Linux to and from the same USB flash drive.
Preparing the USB flash drive

Begin by formatting the USB flash drive as FAT32. Then create the following folders on the newly formatted drive.

  • Boot
    • Boot/ISOs
    • Boot/Settings
Copy the needed files to the USB flash drive

Next copy the ISO that you would like to boot to the Boot/ISOs folder. After that, extract from the following files from the latest release of syslinux from here and copy them into the following folders.

  • ./win32/syslinux.exe to the Desktop or Downloads folder on your system.
  • ./memdisk/memdisk to the Settings folder on your USB flash drive.
Create the configuration file

After copying the needed files, navigate to the USB flash drive, /boot/Settings and create a syslinux.cfg file.

Note: On the INITRD line, be sure to use the name of the ISO file that you copied to your ISOs folder.
/Boot/Settings/syslinux.cfg
DEFAULT arch_iso

LABEL arch_iso
        MENU LABEL Arch Setup
        LINUX memdisk
        INITRD /Boot/ISOs/archlinux-version-x86_64.iso
        APPEND iso

For more information see the Syslinux article.

Final steps

Finally, create a *.bat file where syslinux.exe is located and run it ("Run as administrator" if you are on Vista or Windows 7):

C:\Documents and Settings\username\Desktop\install.bat
@echo off
syslinux.exe -m -a -d /Boot/Settings X:

Inadvisable methods

Warning: The following methods are discouraged.

Using etcher

etcher contains analytics and first-party advertising. See [4], [5] and [6].

Using Universal USB Installer

  • The download page contains fake Download buttons that may contain malware.
  • Universal USB Installer does not write the ISO as-is which breaks BIOS booting due to the discrepancy in syslinux versions. See [7].
  • The Arch Linux installation image's boot loaders expect the ISO contents to reside on volume with the label ARCH_YYYYXX. Universal USB Installer does not update the file system label, nor does it correct the boot loader configuration.

Using UNetbootin

  • UNetbootin does not write the ISO as-is which breaks BIOS booting due to the discrepancy in syslinux versions.
  • The Arch Linux installation image's boot loaders expect the ISO contents to reside on volume with the label ARCH_YYYYXX. UNetbootin does not update the file system label, nor does it correct the boot loader configuration.

Troubleshooting

Device does not show up

If you get the device did not show up after 30 seconds error due to /dev/disk/by-label/ARCH_YYYYMM not mounting, try renaming your USB medium to ARCH_YYYYMM so Arch can find it. (e.g. For archlinux-2021.02.01-x86_64.iso, use ARCH_202102).

Failed to set up loop devices: No such file or directory

If you get losetup: /run/archiso/bootmnt/arch/x86_64/airootfs.sfs: failed to set up loop devices: No such file or directory, try using a USB 2.0 port. For example, some USB 3.0 ports through USB hubs do not work.

Other errors

If you get other errors, try using another USB device. There are multiple scenarios in which it solved all issues.

See also