Skip to content
NAKA-MURA Hayate edited this page Aug 14, 2023 · 20 revisions

How To Build The ISO Image

  1. Edit configuration files in profile directory.
  2. Execute sudo ./mkdebiso <profile directory>
  3. There are points where the input is required in the middle, and the necessary value is input by the keyboard.
  4. An ISO image is created in the "out" directory.

Configuration File List

profiledef.sh

Config file such as the ISO file name.

List of variables

  • DISTRO_NAME
    Distro's name.
  • DISTRO_UNAME
    Distro's unix-name. It consists of a lowercase letter, a number from 0 to 9, and a hyphen or underscore.
  • DISTRO_VERSION
    Distro's version.
  • DEBIAN_VERSION
    Debian's version codename. Tested version is bookworm only.
  • MIRROR_URL
    Repository mirror URL.

sources.list

List of package repository list. When adding external repositories, such as when operating your own repository, add the GPG keys in "trusted.gpg.d".

trusted.gpg.d

Directory in which to place the dearmored GPG keys described above.

packages.amd64

List of deb packages to install.

flatpak_packages.amd64 (create as needed)

List of Flatpak packages to install. Only installation from Flathub is supported.

purge_packages.amd64 (create as needed)

List of deb packages to remove. Sometimes unwanted packages are installed (e.g. if you try to install LXQt, it somehow comes with Xfce and even GNOME), so it is better to have this list in order to remove such unnecessary packages after installation.

grub/grub.cfg

ISO bootloader configuration file.

dirootfs/

Files to add to filesystem on live environment. For example, dconf, auto login settings, and desktop themes.

etc/hostname

A file that records the hostname of the live environment.

root/customise_dirootfs.d/ (create as needed)

A directory containing the ISO's file system configuration scripts.

preinstall.sh (create as needed)

Script that runs before installing deb packages.

postinstall.sh (create as needed)

Script that runs after installing deb packages.

Clone this wiki locally