ltsp-build-client(8) 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
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
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