CHROOT(1) User Commands CHROOT(1)

chroot - run command or interactive shell with special root directory

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

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 '/'
display this help and exit
output version information and exit

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

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

Written by Roland McGrath.

GNU coreutils online help: https://www.gnu.org/software/coreutils/
Report any translation bugs to https://translationproject.org/team/

Copyright © 2025 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later https://gnu.org/licenses/gpl.html.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

chroot(2)

Full documentation https://www.gnu.org/software/coreutils/chroot
or available locally via: info '(coreutils) chroot invocation'

April 2025 GNU coreutils 9.7
OSZAR »