chroot(1) — Linux manual page


CHROOT(1)                     User Commands                    CHROOT(1)

NAME         top

       chroot - run command or interactive shell with special root

SYNOPSIS         top

       chroot [OPTION] NEWROOT [COMMAND [ARG]...]
       chroot OPTION

DESCRIPTION         top

       Run COMMAND with root directory set to NEWROOT.

              specify supplementary groups as g1,g2,..,gN

              specify user and group (ID or name) to use

              do not change working directory to '/'

       --help display this help and exit

              output version information and exit

       If no command is given, run '"$SHELL" -i' (default: '/bin/sh

   Exit status:
       125    if the chroot command itself fails

       126    if COMMAND is found but cannot be invoked

       127    if COMMAND cannot be found

       -      the exit status of COMMAND otherwise

AUTHOR         top

       Written by Roland McGrath.

REPORTING BUGS         top

       GNU coreutils online help:
       Report any translation bugs to

COPYRIGHT         top

       Copyright © 2023 Free Software Foundation, Inc.  License GPLv3+:
       GNU GPL version 3 or later <>.
       This is free software: you are free to change and redistribute
       it.  There is NO WARRANTY, to the extent permitted by law.

SEE ALSO         top


       Full documentation
       or available locally via: info '(coreutils) chroot invocation'

COLOPHON         top

       This page is part of the coreutils (basic file, shell and text
       manipulation utilities) project.  Information about the project
       can be found at ⟨⟩.  If you
       have a bug report for this manual page, see
       ⟨⟩.  This page was obtained
       from the tarball coreutils-9.4.tar.xz fetched from
       ⟨⟩ on 2023-12-22.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to

GNU coreutils 9.4              August 2023                     CHROOT(1)

Pages that refer to this page: systemd-nspawn(1)chroot(2)lxc.container.conf(5)mount_namespaces(7)btrfs-receive(8)pivot_root(8)