From fbc2bd4cea5240b94b84b7e294eff2b6306921f4 Mon Sep 17 00:00:00 2001 From: n8fr8 Date: Wed, 1 Jul 2026 19:01:31 -0400 Subject: [PATCH] add note about amd64 prereqs for building --- README.md | 12 ++++++++++++ vmdb2-recipes/amd64_trixie.yaml | 3 +++ 2 files changed, 15 insertions(+) diff --git a/README.md b/README.md index 5f9374d..b59e97b 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,18 @@ Tool for building Butter Box disk images. +## Host prerequisites + +The build host needs `vmdb2` and, for the amd64 image, the `syslinux-common` +package — the amd64 recipe writes GPT protective-MBR boot code +(`/usr/lib/syslinux/mbr/gptmbr.bin`) directly to the output image from the host +filesystem, so this package must be present on the build machine (not just +inside the target image): + +```sh +sudo apt install syslinux-common +``` + ## Usage To build a butter image, run: diff --git a/vmdb2-recipes/amd64_trixie.yaml b/vmdb2-recipes/amd64_trixie.yaml index 23669fe..e859704 100644 --- a/vmdb2-recipes/amd64_trixie.yaml +++ b/vmdb2-recipes/amd64_trixie.yaml @@ -63,6 +63,9 @@ steps: - mount: tag-root + # NOTE: gptmbr.bin is read from the HOST filesystem (not the target rootfs), + # so the `syslinux-common` package must be installed on the build machine: + # sudo apt install syslinux-common - shell: | dd bs=440 count=1 conv=notrunc if=/usr/lib/syslinux/mbr/gptmbr.bin of="{{ output }}" root-fs: tag-root