A collection of vmdb2 recipes and ansible playbooks to deploy a butter-box.

Find a file

Ana Custura f334bd419b Mask WPA supplicant to fix suspected timing issue sometimes preventing the AP from starting		2026-07-10 16:13:48 +01:00
ansible	Mask WPA supplicant to fix suspected timing issue sometimes preventing the AP from starting	2026-07-10 16:13:48 +01:00
docs	add in link to original blog post	2026-04-13 22:43:45 -04:00
vmdb2-recipes	add note about amd64 prereqs for building	2026-07-01 19:01:31 -04:00
.gitmodules	Refactoring and vmdb2 improvements	2025-11-07 13:24:44 +00:00
LICENCE	docs: add BSD licence and enhance README	2026-04-06 11:09:26 +01:00
README.md	add note about amd64 prereqs for building	2026-07-01 19:01:31 -04:00

README.md

Butter Churn

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):

sudo apt install syslinux-common

Usage

To build a butter image, run:

vmdb2 --rootfs-tarball=my_image.tar.gz --output my_image.img --log my_image.log

Advanced Documentation

Copyright and Licence

See LICENCE for details of the BSD-3 clause licence.

This project is a derivative work of:

Butter Box for Raspberry Pi licensed under the MIT licence.
Raspberry Pi Image Specs licensed under the 3-clause BSD licence.