---
name: "ltsp-chroot"
section: "8"
platform: "linux"
package: "ltsp-server"
version: "5.18.12-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/ltsp-chroot"
---

# ltsp-chroot(8)

chroot into a specific LTSP thin client chroot

## NAME

ltsp-chroot - chroot into a specific LTSP thin client chroot

## SYNOPSIS

**ltsp-chroot** \[*OPTION*\] *command*

## DESCRIPTION

Chroots into a specified LTSP chroot. Optional arguments can be provided to customize the chroot location as well as extra mounts. If present, default arguments will be read from the configuration file */etc/ltsp/ltsp-chroot.conf*, and overwritten with used command line options.

## OPTIONS

- **-a**, **--arch**\[=*ARCH*\]

  Sets the architecture of the target chroot. Defaults vary by distribution.

- **-b**, **--base**\[=*PATH*\]

  Sets base of target chroot. Defaults to */opt/ltsp* if unspecified.

- **-c**, **--mount-package-cache**

  If set, mounts the server package directories to the chroot previous to chrooting. Settings vary by distribution.

- **-d**, **--mount-dev**

  If set, mounts the server dev and devpts directories to the chroot previous to chrooting.

- **-h**, **--help**

  Displays the ltsp-chroot help message.

- **-p**, **--mount-proc**

  If set, mounts the server */proc* to the chroot previous to chrooting.

- **-m**, **--mount-all**

  If set, mounts the */proc*, */dev* and package directories to the chroot before chrooting.

- **-r**, **--copy-resolv-conf**

  If set, copies the server resolv.conf to the chroot previous to chrooting.

- **--version**

  Output version information and exit.

## AVAILABILITY

Part of the **ltsp** package and the latest versions are available in source form from  *https://launchpad.net/products/ltsp*.

## FILES

*/etc/ltsp/\<tool\>.conf*: Upon execution the tool will read a configuration file to override built-in defaults.

Values are NAME="VALUE" pairs, with # representing commented lines. most commandline options have an equivalent. an example Debian based system with an alternate base location, architecture, and distribution:

 \# set alternate default location for ltsp chroot (--base)\
  BASE="/srv/ltsp"\
  \# build an amd64 chroot by default (--arch)\
  ARCH="amd64"\
  \# build a Debian sid environment (--dist)\
  DIST="sid"

*/etc/ltsp/ltsp-server.conf*: Each LTSP server tool will read a generic configuration file. This file is typically used for setting BASE, TFTP\_DIRS and TFTP\_BOOT\_DIR. These settings are overwritten by those set in specific tool configs.

## AUTHOR

Autogenerated from the script source code with **help2man**. Distributed under the terms of the GNU General Public License version 2 or any later version.

## REPORTING BUGS

Report bugs to *https://bugs.launchpad.net/ltsp*.

## SEE ALSO

[**ltsp-build-client**(8)](/ltsp-build-client/8.md), [**chroot**(1)](/chroot/1.md)