NAME

       arch-chroot - enhanced chroot command

SYNOPSIS

       arch-chroot [options] chroot-dir [command] [arguments...]

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/chroot

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)

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.

AUTHORS

       Maintainers:

       •   Dave Reisner <dreisner@archlinux.org>

       •   Eli Schwartz <eschwartz@archlinux.org>

       For additional contributors, use git shortlog -s on the arch-install-scripts.git
       repository.

                                            11/22/2022                             ARCH-CHROOT(8)