Difference between revisions of "Chroot"

From ArchWiki
Jump to: navigation, search
(update templates, see Help:Style)
(do bind mounts for chroot's /proc and /sys)
Line 33: Line 33:
  cd /mnt/arch
  cd /mnt/arch
  mount -t proc proc proc/
  mount -o bind /proc proc/
  mount -t sysfs sys sys/
  mount -o bind /sys sys/
  mount -o bind /dev dev/
  mount -o bind /dev dev/

Revision as of 16:26, 14 April 2012

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 – فارسی

Changing Root is the process of changing of the apparent disk root directory (and the current running process and its children) to another root directory. When you change root to another directory you cannot access files and commands outside that directory. This directory is called a chroot jail. Changing root is commonly done for system maintenance for such tasks as reinstalling GRUB or resetting a forgotten password. Changing root is often done from from a LiveCD or LiveUSB into a mounted partition that contains an installed system.


  • You'll need to boot to another working Linux environment (for example, to a LiveCD or USB flash disk). For Arch install mediums there is both the LiveCD and USB Flash disk.
  • Root privileges are required in order to chroot.
  • Be sure that the architectures of the Linux environment you have booted into matches the architecture of the root directory you wish to enter (i.e. i686, x86_64). You can find the architecture of your current environment by:
uname -m
  • If you need any kernel modules loaded in the chroot environment, load them before chrooting. It may also be useful to initialize your swap (swapon /dev/<device-or-partition-name>) and to connect to your network before chrooting.

Mounting the device

The device or partition with the Linux system on it will need to be mounted. To discover the kernel name of the storage device name, type:

fdisk -l

Create a directory where you would like to mount the device or partition, then mount it:

mkdir /mnt/arch
mount /dev/<device-or-partition-name> /mnt/arch

Changing Root

Mount the temporary filesystems:

cd /mnt/arch
mount -o bind /proc proc/
mount -o bind /sys sys/
mount -o bind /dev dev/

Mount other parts of your filesystem (e.g. /boot, /var, /usr...) that reside on separate partitions but which you need access to. For example:

mount /dev/<device-or-partition-name> boot/

It's possible to mount filesystems after you've chrooted, but it's more convenient to do so beforehand. The reasoning for this is you'll have to unmount the temporary filesystems after you exit a chroot so this lets you umount all the filesystems in a single command. This also allows a safer shutdown. Because the external Linux environment knows all mounted partitions it can safely unmount them during shutdown.

If you've setup your network and want to use it in the chroot environment, copy over your DNS servers so that you will be connected to the network:

cp -L /etc/resolv.conf etc/resolv.conf

Now chroot to your installed device or partition and define your shell:

chroot . /bin/bash

If you see the error, "chroot: cannot run command '/bin/bash': Exec format error" it is likely the two architectures do not match.

If you use bash, your root $HOME/.bashrc will be sourced on login provided your ~/.bash_profile specifies it (source ~/.bashrc). To source your chrooted, global bash configuration do:

 source /etc/profile

If your bash configuration doesn't use a unique prompt, consider creating one to be able to differentiate your chroot environment:

 export PS1="(chroot) $PS1"

Perform System Maintenance

At this point you can perform whatever system maintenance you require inside the chroot environment, some common examples being:

Exiting chroot

When you're finished with system maintenance, exit the chroot shell:


Then unmount the temporary filesystems and any mounted devices:

umount {proc,sys,dev,boot...}

Finally attempt to unmount your hard drive:

cd ..
umount arch/

If you get an error saying that /mnt (or any other partition) is busy, this can mean one of two things:

  • A program was left running inside of the chroot.
  • Or more frequently: a sub-mount still exists. For example, /mnt/arch/usr within /mnt/arch.

In the latter case, unmount the sub-mount mount point first. To get a reminder of all the current mount points, run mount with no parameters. If you still are unable to mount a partition, use the force option:

umount -f /mnt

After this you will be able to safely reboot.