ltsp-build-client - build an LTSP client system for use with the LTSP server


LTSP Build Client usage:

ltsp-build-client <options>


Regular options:


set the distribution to be used for install, defaults to running distribution


display help for all available commandline options


display this help message


set the mirror location


output version information and exit

Advanced options:

--accept-unsigned-packages allow unsigned packages during install


include the listed keys in the apt keyring


set the target architecture


distribution to pull backports from


add a backports mirror


list of packages to install from the backports repositories


set the default base install directory


set the name of the chroot


set the components to be used in mirror


load a user specific configuration file


cache downloaded packages


copy apt Packages files from server


use the servers sources.list instead of generating one


create ext2 image for use with NBD


create image for use with NBD of the specified filesystem


load debconf seeding in the chroot after install


use the specified keyring for debootstrap gpg verification


enable debug support


add a mirror, which takes priority over the default mirror


set the list of packages to install after base-install is completed


use eatmydata to speed up build times, at risk of data not getting written to disk


enable popularity-contest in the chroot


exclude packages from the initial chroot


add a mirror, with lower priority than the default mirror


run most or all applications locally


use specified http proxy


install to the chroot all the .deb files contained in the provided directory


keep cache of downloaded package files


set the list of kernel packages to install


set the kernel variant to install


set the kernel version to install


a simple webkiosk mode


list of packages to install as part of the final installation


set the default locale


mount package cache dir from server


mount a server directory as the chroot package cache dir


use NFS instead of NBD as default


do not autodetect apt proxy configuration


skip squashfs image creation


distribution to set up apt pinning


list of packages to install from the pinned distribution


prompt to set the root password, defaults to disabled


purge existing LTSP chroot if present


add a security mirror


enable serial console


skip upgrade of installed packages


create squashfs image for use with NBD


trust mirrors of file:/// type


set the update mirror location


Part of the ltsp package and the latest versions are available in source form from


/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)
# build an amd64 chroot by default (--arch)
# build a Debian sid environment (--dist)

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


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


Report bugs to


ltsp-update-sshkeys(8), ltsp-update-kernels(8)