arch-chroot - enhanced chroot command
Contents
Bugs
Bugs can be reported on the bug tracker https://bugs.archlinux.org in the Arch Linux category and title
prefixed with [arch-install-scripts] or via arch-projects@archlinux.org.
Description
arch-chroot wraps the chroot(1) command while ensuring that important functionality is available, e.g.
mounting /dev/, /proc and other API filesystems, or exposing resolv.conf(5) to the chroot.
If command is unspecified, arch-chroot will launch /bin/bash.
Note
The target chroot-dir should be a mountpoint. This ensures that tools such as pacman(8) or findmnt(8)
have an accurate hierarchy of the mounted filesystems within the chroot. If your chroot target is not
a mountpoint, you can bind mount the directory on itself to make it a mountpoint, i.e.:
mount--bind/your/chroot/your/chrootName
arch-chroot - enhanced chroot command
Options
-N
Run in unshare mode. This will use unshare(1) to create a new mount and user namespace, allowing
regular users to create new system installations.
-u<user>[:group]
Specify non-root user and optional group to use.
-h
Output syntax and command line options.
See Also
pacman(8)
Synopsis
arch-chroot [options] chroot-dir [command] [arguments...]
