This chapter discusses further customisation of the live system.
Using includes, it is possible to add (or replace) arbitrary files in your Debian Live image. live-helper
provides three mechanisms for using them:
These allow you to add or replace files to the chroot/Live filesystem. Please see Section 5.2.1.1, “Live/chroot local includes” for more information.
These allow you to add or replace files in the binary image. Please see Section 5.2.1.2, “Binary local includes” for more information.
These allow you to add or replace Debian specific files in the binary image, such as the templates and tools directories. Please see Section 5.2.1.3, “Binary includes” for more information.
Please see Section 1.1.1, “Terms” for more information about the distinction between the "Live" and "binary" images.
Chroot local includes can be used to add or replace files in the chroot/Live filesystem so that they are visible when the Live system is booted. Typical uses for them are to populate the skeleton user directory (/etc/skel
) or adding configuration files where additional processing is not required.
To include files, simply add them to your config/chroot_local-includes
directory. This directory corresponds to the root directory (/
) of the live system. For example, to add a file /var/www/index.html
in the live system, use:
$ mkdir -p config/chroot_local-includes/var/www $ cp /path/to/my/index.html config/chroot_local-includes/var/www
Your configuration will then have the following layout:
-- config [...] |-- chroot_local-includes | `-- var | `-- www | `-- index.html [...] `-- templates
Chroot local includes are installed after package installation so that files installed by packages are overwritten.
FIXME.
Enabling hooks
Files in the config/chroot_local-preseed
directory are considered to be debconf preseed files and are installed by live-helper
using debconf-set-selections
.
For more information about debconf, please see debconf(7) in the debconf package.