Setup And Installation

To build a Debian image with lbhelper, you need:

1. A system with runnable live build binary. In general, if you run with Debian based Linux distribution, you can install it via

   sudo apt install live-build
   

   For non-Debian based system, the live build official documents might help.

2. Install lbhelper with any package managers you prefer(make sure you have Python>=3.13 for best support):

   pip install -y lbhelper
   

Containerized/Virtualized Environment

Generally, lbhelper can run within any containerized or virtualized environment. However, installing some packages requires a fully functional environment and shell (e.g., dictionaries-common). To avoid possible issues, we recommend that running lbhelper on your system or a VM. If you’re trying to run in a container, please consider to use the Distrobox with assemble manifest like:

[debian-builder]
additional_packages="git vim live-build"
image=debian:trixie
home=/tmp/lbhelper-build
additional_flags="--cap-add=CAP_SYSLOG --cap-add=CAP_SYS_ADMIN --privileged"
start_now=true
root=true