acj/FreeBSD Firecracker VM

Launch a FreeBSD VM in Firecracker and run a script inside it

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Jul 10, 2026
License: Apache 2.0

Pinned Snippet

workflow.ymlSHA-pinned

uses: acj/freebsd-firecracker-action@bfdf2c8588fe913617bc393067e581bfe4e77706 # v0.10.2

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
kernel-url	—	no	https://github.com/acj/freebsd-firecracker/releases/download/v0.10.1/freebsd-kern.bin
rootfs-url	—	no	https://github.com/acj/freebsd-firecracker/releases/download/v0.10.1/freebsd-rootfs.bin.xz
firecracker-url	—	no	https://github.com/acj/freebsd-firecracker/releases/download/v0.10.1/firecracker
ssh-public-key-url	—	no	https://github.com/acj/freebsd-firecracker/releases/download/v0.10.1/freebsd.id_rsa.pub
ssh-private-key-url	—	no	https://github.com/acj/freebsd-firecracker/releases/download/v0.10.1/freebsd.id_rsa
pre-run	An optional script to run before starting the FreeBSD virtual machine. This script runs on the host. By default, it copies the contents of the workspace directory into the VM.	no	exclude_path="$(mktemp)" cat <<EOF > $exclude_path .git .github .gitignore .gitmodules LICENSE README.md README.txt README action.yml EOF rsync -r -e "ssh" \ --relative \ --copy-links \ --exclude-from "$exclude_path" \ . firecracker: rm -f "$exclude_path"
run-in-vm	The script to run inside the FreeBSD virtual machine	yes	—
post-run	An optional script to run after the `run-in-vm` script exits. This script runs on the host. By default, it copies the contents of the VM's `/root` directory into the workspace directory.	no	rsync -r -e "ssh" \ --relative \ --copy-links \ --exclude-from "$exclude_path" \ firecracker: .
checkout	—	no	true
continue-on-error	—	no	false
verbose	—	no	false
disk-size	—	no	2G
vcpu-count	Number of vCPUs to expose to the VM. Use "auto" to match the host's logical core count.	no	auto

Outputs

no outputs