Skip to content

debootstrap-builder

Version 2026.195.0600
Repo superproject

Privileged builder toolchain that bootstraps and makes bootable a Debian-family rootfs from scratch Tools needed to bootstrap a Debian-family rootfs from scratch via debootstrap, partition a VM disk, and install grub-efi for a bootable Debian/Ubuntu system. Used as the layer composition for the debian-debootstrap-builder / ubuntu-debootstrap-builder images, which run as privileged containers under charly box build and charly vm build for kind:bootstrap source kinds.

Counterpart of candy/pacstrap-builder; both compose the same disk-build toolchain (qemu-img + parted + mkfs + grub-efi) plus the family-specific bootstrap tool. Verifiable at build scope: each tool ships a named binary on PATH and a registered dpkg package.

Installed on every distro:

  • debootstrap
  • debian-archive-keyring
  • ubuntu-keyring
  • qemu-utils
  • dosfstools
  • e2fsprogs
  • xfsprogs
  • btrfs-progs
  • parted
  • util-linux
  • grub-efi-amd64-bin
  • grub-common
  • grub2-common
  • efibootmgr
  • mount
  • ca-certificates

This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.

Intent Step
check the debootstrap bootstrap tool is installed at /usr/sbin/debootstrap
check the debootstrap package is registered in the dpkg database
check qemu-img is available to create and convert the VM disk image
check qemu-img runs and reports its version
check parted is available to partition the disk image
check grub-install is present to write the EFI bootloader into the rootfs
check efibootmgr is installed to register the EFI boot entry
check package=e2fsprogs
check package=dosfstools