Revision as of 09:59, 27 August 2012

This guide is intended to combine and update the three previously existing and highly similar alternative install guides on this wiki. This guide is intended for anybody who wants to install Arch Linux from any other running Linux -- be it off a LiveCD or a pre-existing install of a different distro.

Overview

Arch Linux's pacman can be configured (-r) to perform operations in any directory you like, using that as the context of "root" while running.

This is useful for building up new Arch Linux systems from scratch from another distro's LiveCD or existing installation. It is also useful for creating new chroot environments on a "host" system, maintaining a "golden-master" for development & distribution, or other fun topics like rootfs-over-NFS for diskless machines.

This guide requires that the existing host system be able to execute the new target Arch Linux architecture programs. In the case of an x86_64 host, it is possible to use i686-pacman to build a 32-bit chroot environment. See Arch64 Install bundled 32bit system. However it is not so easy to build a 64-bit environment when the host only supports running 32-bit programs.

Throughout this guide, we will refer to partitions as /dev/hdxx or /dev/sdxx. This refers to whatever dev entry you have on your system for the partition in question. The convention is:

We will refer to it as /dev/sdxx whenever possible, but realize depending on your system it could be /dev/hdxx.

In this article,

host

refers to the computer which is used to perform the installation.

target

refers to the computer where you want to install Arch.

These may be one and the same computer. The host does not need to be an Arch system -- it can be a Debian or Redhat system, for example. The section entitled "Setup the host system" explains how to install pacman on the host. The following section "Setup the target system" explains how to use pacman from the host system to install Arch on the target system. Therefore if the host system is already running Arch, you can skip to "Setup the target system".

Setup the host system

You need to install the Arch Linux package manager, pacman, on your host Linux environment. In addition you will need a list of pacman mirror sites which is used to download data on available packages as well as the packages themselves. If you are already using Arch, skip this step and go to Install from Existing Linux#Setup the target system.

Get the required packages

Introduction

You need to get the required packages for your host Linux environment. The examples given here assume you are using an i686 environment. If you are running on a 64-bit Linux instead you should replace each occurrence of "i686" with "x86_64".

All version numbers given here may change. Please check the version numbers the packages are at first and note them down. The version numbers can be found at:

To prepare for using pacman, do not forget to edit /tmp/archlinux/etc/pacman.conf to point to /tmp/archlinux/etc/pacman.d/mirrorlist and select your favorite mirror. For easier use (assuming you are using bash or zsh), you may set up an environment:

Install pacman on the host system

Note: (Issues while running pacman on 64-bit host) If while running pacman you end up with /tmp/archlinux/usr/bin/pacman: No such file or directory please symlink ld-linux-x86-64.so.2: ln -s /lib64/ld-linux-x86-64.so.2 /lib/

If you do not mind littering your install host, you can extract all the downloaded tar balls into your root directory by running as root:

Note: However, keep in mind that this operation could erase some of your files, and break your system.

cd /
for f in /tmp/archlinux/pacman-*pkg.tar.gz ; do
tar xzf $f
done

If installing from Ubuntu 9.10's LiveCD (perhaps other versions), you will need more than just the pacman files (shared libs) to use pacman at all. Use Lucky's script described in [this thread] to get/install them for you!

Alternatively, you can instead turn these tarballs into packages for your distribution with the alien tool. See the man page of the tool for instructions. The packages created that way may be installed into your host distribution using the usual package management tools available there. This approach offers the best integration into the host Linux environment. For a Debian package based system this is done with the following commands:

Configure the host system

The main goal of this operation is to make a proper configuration to pacman.

Configure your /etc/pacman.conf to your liking, and remove unnecessary mirrors from /etc/pacman.d/mirrorlist. Also, enabling at least a few mirrors might become necessary, as you may experience errors during syncing if you have no mirror set. You may want to manually resolve DNS in the /etc/pacman.d/mirrorlist, because pacman for i686 may not be able to get address information on x86_64 systems.

If you are installing from a LiveCD, and you have a system with a low amount of combined RAM and swap (< 1 GB), be sure to set the cachedir in /etc/pacman.conf to be in the new Arch partition (e.g. /newarch/var/cache/pacman/pkg). Otherwise you could exhaust memory between the overhead of the existing distro and downloading necessary packages to install.

Setup the target system

Prepare a partition for Arch

You do not have to install Arch on a separate partition. You could instead build up a root filesystem in a normal directory, and then create a master tarball from it, or transfer it across the network.

However, most users will want to be installing Arch onto its own partition.

Prepare any partitions and filesystems you need for your installation. If your host system has any GUI tools for this, such as gparted, cfdisk, or Mandrake's diskdrake, feel free to use them.

To format a partition as ext4, you run (where /dev/sdxx is the partition you want to setup):

mkfs.ext4 /dev/sdxx

To format it as ext3 with journaling and dir_index:

mkfs.ext4 -j -O dir_index /dev/sdxx

To format it as reiserfs:

mkreiserfs /dev/sdxx

To format a partition as swap, and to start using it:

mkswap /dev/sdxx
swapon /dev/sdxx

Most other filesystems can be setup with their own mkfs variant, take a look using tab completion. Available filesystems depend entirely on your host system.

Once you have your filesystems setup, mount them. Throughout this guide, we will refer to the new Arch root directory as /newarch, however you can put it wherever you like.

new_arch=/newarch
mkdir ${new_arch}
mount /dev/sdxx ${new_arch}

Install the core

Update pacman. You may have to create the /newarch/var/lib/pacman folder for it to work (see "Setup the host system" above):

Chroot

In order for DNS to work properly you need to edit ${new_arch}/etc/resolv.conf or replace it with the resolv.conf from your running distribution

cp /etc/resolv.conf ${new_arch}/etc/

Also, you need to copy a correctly setup mirrorlist into the new system:

cp /etc/pacman.d/mirrorlist ${new_arch}/etc/pacman.d

Finally edit the pacman configuration file ${new_arch}/etc/pacman.conf setting "Architecture" so that it matches the one of the target system.
The default of "auto" might fail if it is different from the host system.

If you have a separate /boot partition, you will probably need to mount that too. See Change Root for more details.

Warning: If you have a separate /boot partition and plan on using grub2, make sure to mount /boot after chrooting. If you mount the /boot partition before the chroot, grub2 will assume that /boot and root are on the same partition and will not update correctly.

Install the rest

Install your preferred kernel, and any other packages you may wish to install.
For the default kernel (which is already installed!):

pacman -S --needed linux

If you wish to install extra packages now, you may do so with:

pacman -S packagename

Configure the target system

Edit your /etc/fstab, remembering to add /, swap and any other partitions you may wish to use. Be sure to use the /dev/sd* (sda1, sda2, sdb1, etc) for the partitions instead of /dev/hd*, as Arch uses the sdxx convention for all drives.

Edit your /etc/rc.conf, /etc/hosts and /etc/mkinitcpio.conf to your needs. If you are installing Arch Linux to a USB flash drive, don't forget to add the usb hook to /etc/mkinitcpio.conf. Then, rebuild the initcpio image:

mkinitcpio -p linux

Edit /etc/locale.gen, uncommenting any locales you wish to have available, and build the locales:

locale-gen

Setup Grub

To use GRUB when chrooted, you need to ensure that /etc/mtab is up-to-date:

diff /etc/mtab /proc/mounts

If you get any output from the previous command, run:

grep -v rootfs /proc/mounts > /etc/mtab

You can now run:

grub-install /dev/sdx

If grub-install fails, you can manually install:

grub
grub> find /boot/grub/stage1 (You should see some results here if you have done everything right so far. If not, back up and retrace your steps.)
grub> root (hd0,X) (Note that Grub 1 and Grub 2 differ in how they each handle partition numbering. See the GRUB articles for info.)
grub> setup (hd0)
grub> quit

Double-check your /boot/grub/menu.lst. Depending on the host, it could need correcting from hda to sda, and a prefix of /boot as well in the paths.

Manual recovery of GRUB libs

The *stage* files are expected to be in /boot/grub, which may not be the case if the bootloader was not installed during system installation or if the partition/filesystem was damaged, accidentally deleted, etc.

Manually copy the grub libs like so:

# cp -a /usr/lib/grub/i386-pc/* /boot/grub

Note: Do not forget to mount the system's boot partition if your setup uses a separate one! The above assumes that either the boot partition resides on the root filesystem or is mounted to /boot on the root file system!

Finishing touches

exit
umount ${new_arch}/boot # if you mounted this or any other separate partitions
umount ${new_arch}/{proc,sys,dev}
umount ${new_arch}

Reboot to your new Arch system!

An alternate, simpler installation method

This method is verified to be working as of 1-4-12.
This works best if you are in a LiveCD environment (or, in the case of servers, a GNU/Linux-based rescue environment). Firstly, you need to mount the disk you want to use for the Archlinux installation at /mnt. In this example, /dev/sda1 is used.