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
) used by the live system to create
the live user's home directory, 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.