1ARCH-CHROOT(8)                                                  ARCH-CHROOT(8)
2
3
4

NAME

6       arch-chroot - enhanced chroot command
7

SYNOPSIS

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

DESCRIPTION

12       arch-chroot wraps the chroot(1) command while ensuring that important
13       functionality is available, e.g. mounting /dev/, /proc and other API
14       filesystems, or exposing resolv.conf(5) to the chroot.
15
16       If command is unspecified, arch-chroot will launch /bin/bash.
17
18           Note
19           The target chroot-dir should be a mountpoint. This ensures that
20           tools such as pacman(8) or findmnt(8) have an accurate hierarchy of
21           the mounted filesystems within the chroot. If your chroot target is
22           not a mountpoint, you can bind mount the directory on itself to
23           make it a mountpoint, i.e.:
24
25           mount --bind /your/chroot /your/chroot
26

OPTIONS

28       -N
29           Run in unshare mode. This will use unshare(1) to create a new mount
30           and user namespace, allowing regular users to create new system
31           installations.
32
33       -u <user>[:group]
34           Specify non-root user and optional group to use.
35
36       -h
37           Output syntax and command line options.
38

SEE ALSO

40       pacman(8)
41

BUGS

43       Bugs can be reported on the bug tracker https://bugs.archlinux.org in
44       the Arch Linux category and title prefixed with [arch-install-scripts]
45       or via arch-projects@archlinux.org.
46

AUTHORS

48       Maintainers:
49
50       •   Dave Reisner <dreisner@archlinux.org>
51
52       •   Eli Schwartz <eschwartz@archlinux.org>
53
54       For additional contributors, use git shortlog -s on the
55       arch-install-scripts.git repository.
56
57
58
59                                  07/19/2023                    ARCH-CHROOT(8)