5.2. Customising contents

This chapter discusses further customisation of the live system.

5.2.1. Includes

Using includes, it is possible to add (or replace) arbitrary files in your Debian Live image. live-helper provides three mechanisms for using them:

Chroot local includes

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.

Binary local includes

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.

Binary includes

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.

5.2.1.1. Live/chroot local includes

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.

5.2.1.2. Binary local includes

FIXME.

5.2.1.3. Binary includes

FIXME.

5.2.2. Hooks

FIXME.

Enabling hooks

5.2.2.1. Live/chroot local hooks

FIXME.

5.2.2.2. Binary local hooks

FIXME.

5.2.3. Preseeding Debconf questions

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.

5.2.4. Symlink conversion

FIXME. (This is probably in the wrong section)