Appendix A - Generating the ISO

Official downloads of the Hedgehog Linux installer ISO are not provided: however, it can be built easily on an internet-connected Linux host with Vagrant:

• Vagrant
  • vagrant-reload plugin
  • vagrant-sshfs plugin
  • bento/debian-12 Vagrant box

The build should work with either the VirtualBox provider or the libvirt provider:

• VirtualBox provider
  • vagrant-vbguest plugin
• libvirt
  • vagrant-libvirt provider plugin
  • vagrant-mutate plugin to convert bento/debian-12 Vagrant box to libvirt format

To perform a clean build the Hedgehog Linux installer ISO, navigate to your local Malcolm working copy and run:

$ ./hedgehog-iso/build_via_vagrant.sh -f
…
Starting build machine...
Bringing machine 'default' up with 'virtualbox' provider...
…

Building the ISO may take 90 minutes or more depending on your system. As the build finishes, you will see the following message indicating success:

…
Finished, created "/sensor-build/hedgehog-24.03.1.iso"
…

Alternately, if you have forked Malcolm on GitHub, workflow files are provided which contain instructions for GitHub to build the docker images and Hedgehog and Malcolm installer ISOs, specifically hedgehog-iso-build-docker-wrap-push-ghcr.yml for the Hedgehog ISO. The resulting ISO file is wrapped in a Docker image that provides an HTTP server from which the ISO may be downloaded.