Build Configuration - duonl/bcld GitHub Wiki

Build Configuration

  • The BCLD build process has many default variables and safeties.
  • BCLD will mostly build an image without issue.
  • Many build parameters have been implemented to further customize the builds.
  • Below is a list of available customizations for building a BCLD-IMG.
  • All Default type variables can be configured in the build configuration.
CONFIG SETTING EXAMPLE DESCRIPTION TYPE
BUILD ENVs
APT_CLEANUP true/false Option to clean chroot after installation. Optional
BCLD_APP /opt/deb-app-afname Full path of the application to launch within BCLD. Overrides DEFAULT_APP. Optional
BCLD_ARCH amd64 Architecture of the distribution used. Default
BCLD_CODE_NAME Omniscius Codename for the BCLD release. Default
BCLD_DATE 14-dec-2022 Date prefix for file name. Default
BCLD_HOME /root Path to ${HOME} within chroot. Default
BCLD_MD5 ./test/bcld.md5 Location of BCLD MD5 within repository. Default
BCLD_MODEL release, debug, test Option for switching between modes. MANDATORY
BCLD_PATCH 1 BCLD patch number. Default
BCLD_PKG_EXTRA r8168-dkms Extra packages to install. Optional
BCLD_RELEASE 11.X BCLD release number. Default
BCLD_REPO_BRANCH main Dummy repo name. Default
BCLD_SECRET ************ SSH password for TEST. Optional
BCLD_TAG_EXTRA r8168 Adds postfix to BCLD_VERSION. Optional
BCLD_TERM xterm-256color BCLD terminal settings. Default
CODE_NAME focal, bionic Ubuntu Release Code Name Default
DEBIAN_FRONTEND noninteractive Use autonomous installers. Default
DEBIAN_PRIORITY critical Critical packages can be installed without interaction. Default
DEFAULT_APP (/usr/bin/qutebrowser &) && /usr/bin/qutebrowser :tab-close Default command to open within BCLD. Default
FAT_LABEL BCLD-USB BCLD disk label. Default
HOME /root Path to ${HOME} on build machine. Default
KEEP_BOOTSTRAP true, false The build either keeps the bootstrap, or deletes it before the next build Optional
KERNEL_MINOR 5.15 Minor kernel release. Default
KERNEL_MODEL generic Kernel model name. Default
KERNEL_PATCH 0-40 Kernel patch and release. Default
LC_ALL C Universal language settings for the console. Default
TEMP, TMP, TMPDIR /tmp Temporary folder Default
UBUNTU_RELEASE 22.04 Ubuntu release. Default
UBUNTU_REPO http://archive.ubuntu.com/ubuntu/ Official Ubuntu repository. Default
UBUNTU_URL http://cdimage.ubuntu.com/ubuntu-base/releases/20.04/release/ubuntu-base-20.04.1-base-amd64.tar.gz Ubuntu Base image URL. Default
WEB_DIR /var/www/html Web directory for RepoMan. Default
BCLD_USER omniscius-release Username within BCLD. Consists of combination of BCLD_CODE_NAME and BCLD_MODEL. Default
KERNEL_SHORT 5.15-0-40 Short kernel name. Combination of KERNEL_MINOR and KERNEL_PATCH. Default
KERNEL_VERSION 5.15-0-40-generic Long kernel name. Combination of KERNEL_SHORT and KERNEL_MODEL. Default
BCLD_VERSION_FILE 14-dec-2022_BCLD-Omniscius-3_TEST.img_BCLD_TAG_EXTRA Full VERSION string for file names. Default
BCLD_VERSION_STRING 12.10-3 BCLD Test (Omniscius) Concatenated VERSION string for human reading. Default

Copyright © 2025 Quintor B.V.

BCLD is licensed under the EUPL, Version 1.2 or – as soon they will be approved by the European Commission - subsequent versions of the EUPL (the "Licence"); You may not use BCLD except in compliance with the Licence. You may obtain a copy of the License at:

https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

⚠️ **GitHub.com Fallback** ⚠️