Installing Arch Linux on a USB key

From ArchWiki
Revision as of 08:08, 10 November 2011 by Twilight (talk | contribs) (Configuration)
Jump to: navigation, search

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.

Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어

External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: please use the first argument of the template to provide a brief explanation. (Discuss in Talk:Installing Arch Linux on a USB key#)

This page discusses how to perform a regular Arch installation onto a USB key (or "flash drive"). The result will be a system that will be updated through normal use. Consider whether you're instead interested in Putting installation media on a USB key.

Grab a big enough USB key

If installing KDE and a large amount of applications, 3 GiB is the recommended minimum. GNOME and Xfce4, along with a typical set of packages for a desktop (GIMP, Pidgin, OpenOffice, Firefox, flashplugin) can be installed on a 2 GiB stick, leaving a small amount of room for user data.

Grab CD

An Arch Linux CD can be used to install Arch onto the USB key, via booting the CD and installing using the regular method. Or, if you have another linux computer available (it needs not be Arch), you can follow the instructions to install from existing linux, and then skip to the configuration section.


It may be necessary to boot with the arch-noscsi kernel, if the usb-storage module gives errors when loaded with the standard kernel. After the system has booted, modprobe sd_mod and usb_storage (There are reports that the 7.2 CD contains no sd_mod; simply omit loading this module, as you can safely proceed without it). The USB key will appear in a few moments, after the device has settled. dmesg will show a device scan once the device has settled:

usbcore: registered new interface driver usb-storage
usb-storage: device found at 4
usb-storage: waiting for device to settle before scanning
USB Mass Storage support registered.
scsi 6:0:0:0: Direct-Access     Generic  STORAGE DEVICE   9407 PQ: 0 ANSI: 0
sd 6:0:0:0: [sdc] 3994624 512-byte hardware sectors (2045 MB)
sd 6:0:0:0: [sdc] Write Protect is off
sd 6:0:0:0: [sdc] Mode Sense: 03 00 00 00
sd 6:0:0:0: [sdc] Assuming drive cache: write through
sd 6:0:0:0: [sdc] 3994624 512-byte hardware sectors (2045 MB)
sd 6:0:0:0: [sdc] Write Protect is off
sd 6:0:0:0: [sdc] Mode Sense: 03 00 00 00
sd 6:0:0:0: [sdc] Assuming drive cache: write through
 sdc: sdc1
sd 6:0:0:0: [sdc] Attached SCSI removable disk
sd 6:0:0:0: Attached scsi generic sg3 type 0
usb-storage: device scan complete

It is the sdX: sdXY line that is important, as it shows the device name (in this case, sdc) and the partitions available on it (in this case, one, sdc1), if any.


Launch the installer (/arch/setup). The setup process can be done normally, with only a few pointers:

  • It is best to manually partition the drive, as the auto partition may not work, and will create unnecessary partitions.
  • If cfdisk fails with "Partition ends in the final partial cylinder" fatal error, the only way to proceed is to kill all partitions on the drive. Open another terminal (Alt+F2), type fdisk /dev/sdX (where sdX is your usb drive), print partition table (p), check that it's ok, delete it (d) and write changes (w). Now return to cfdisk.
  • It is highly recommended to review the Tips for Minimizing SSD Read/Writes on the SSD wiki article prior to selecting a filesystem. To sum up, ext4 with a journal should be fine. Recognize that flash has a limited number of writes, and a journaling file system will take some of these as the journal is updated. For this same reason, it is best to forgo a swap partition. Note that this does not affect installing onto a USB hard drive.
  • When editing the /etc/mkinitcpio.conf, add the usb hook to the hooks array right after udev hook. This necessary module loading in early userspace.


  • Make sure that /etc/fstab includes the correct partition information for /, and for any other partitions on the USB key. If the usb key is to be booted on several machines, it is quite likely that devices and number of available hard disks vary. So it is advised to use UUID or label:

To get the proper UUIDs for your partitions issue blkid

  • menu.lst, the Grub configuration file, should be edited to (loosely) match the following,
Note: When grub is installed on the USB key, the key will always be hd0,0

With the static /dev/sdaX:

root (hd0,0)
kernel /boot/vmlinuz-linux root=/dev/sda1 ro
initrd /boot/initramfs-linux.img

When using label your menu.lst should look like this:

root (hd0,0)
kernel /boot/vmlinuz-linux root=/dev/disk/by-label/Arch ro
initrd /boot/initramfs-linux.img

And for UUID, it should be like this:

root (hd0,0)
kernel /boot/vmlinuz-linux root=/dev/disk/by-uuid/3a9f8929-627b-4667-9db4-388c4eaaf9fa ro
initrd /boot/initramfs-linux.img


USB Support

Should you see that the /arch/setup correctly installed a system on to your USB drive but it stills failed to boot from it by complaining that it could not find the root file system even though it had been specified with UUIDs, then you are most likely missing support for USB. In this case, boot back into your Arch Setup CD/USB media and do the following:

  • chroot into the arch installation contained on the usb drive (don't forget the boot partition, if any)
  • Edit /etc/mkinitcpio.conf, and add "usb" to the "HOOKS=" line after udev:
HOOKS="base udev usb autodetect pata scsi sata filesystems"
  • Regenerate the initrd image by running:
# mkinitcpio -p kernel26

Using UUID

Instead of using literal partition names, you can also use the UUID of your partition. This way is much better and more manageable in a setup where the USB drive is meant to boot at multiple PC's than using the partition literal names (/dev/sdb1). Run:

# blkid

to find out which one points to the regular device node (ie, /dev/sdb1) that is your key.

Now you can place this device node (in the form UUID=7bf1d942-7b8c-4fb7-b55a-d3c40895906d) into /etc/fstab in place of the regular node (ie, /dev/sdb1). Edit also your kernel line in menu.lst, so it will contain something like:

kernel /boot/vmlinuz26 root=/dev/disk/by-uuid/7bf1d942-7b8c-4fb7-b55a-d3c40895906d ro vga=733

Note: The files may contain UUIDs already. Also note that you specifying "root (hdX,X) is also not required when using UUIDs.

Painless boot on different machines without using UUID

When using the USB key on various target machines, it is helpful to have multiple entries in GRUB, for machines with different setups. For example, the GRUB configuration could contain:

# (0) Arch Linux
title  Arch Linux (first drive)
root   (hd0,0)
kernel /boot/vmlinuz26 root=/dev/sda1 ro
initrd /boot/kernel26.img

As well as

# (1) Arch Linux
title  Arch Linux (second drive)
root   (hd0,0)
kernel /boot/vmlinuz26 root=/dev/sdb1 ro
initrd /boot/kernel26.img

And so forth, giving you the option to select a configuration for a wider variety of machines. However, changing the root= option in GRUB does not change /etc/fstab and you must do something (in our example using udev symlink), so the root partition will always be mounted correctly.

  • Run udevinfo -p /sys/block/sdx/ -a (where sdx is the device name of your usb key)
  • Find unique information pertaining to your usb key. I chose `SYSFS{model}=="DataTraveler 2.0"`
  • Make a new file: /etc/udev/udev.rules/10-my-usb-key.rules and insert: KERNEL=="sd**", SYSFS{product}=="DataTraveler 2.0", SYMLINK+="WHATEVERYOUWANTOTCALLIT%n" (KERNEL=="sd**" is because the kernel - 2.6.16 here - names all usb devices sd as it uses the scsi sub-system and you want to look at every sd device and apply the setting to every partition), with SYSFS{model}== being the unique identifier collected from udevinfo.
  • Run /etc/start-udev uevents and make sure the symlinks appears in /dev.
  • If so, edit /etc/fstab, replacing your old sdx with the new symlinks.

Optimizing for the lifespan of flash memory

See Also