Live kickstart / iPXE templates and the distro catalog for bootapi. bootapi git-syncs this repo (every ~3 minutes, like argocd) and hot-swaps its template set on change, so OS and template updates ship by merging here — no bootapi rebuild or redeploy. If this repo is unreachable, bootapi falls back to its embedded copy of these files.

Layout

kickstart/<name>.ks.tmpl     # kickstart templates (Go text/template)
ipxe/<name>.ipxe.tmpl        # iPXE scripts: boot, fallback-local, fallback-shell
catalog/<name>.yaml          # distro catalog: host -> boot images + kickstart
catalog/README.md            # catalog field reference + debian/talos path
ci/shellcheck-post.sh        # %post shellcheck helper (used by CI)

The data model available to templates and the catalog field reference live in the bootapi docs: data-model, template-authoring, and catalog/README.md here.

CI (required before merge)

validate — bootapi validate . renders every kickstart + iPXE script for every catalog distro against a fixture host and fails on any parse/resolve error or unresolved <no value>. Plus shellcheck (error severity) of the %post blocks.
pre-commit — yamllint + whitespace/EOF checks.

Validate locally before pushing:

go run git.unkin.net/unkin/bootapi/cmd/bootapi@main validate .
bash ci/shellcheck-post.sh   # needs shellcheck

Adding a distro

Add catalog/<name>.yaml + kickstart/<name>.ks.tmpl (and, if the OS needs a mirror bootapi can't reach, a terraform-artifactapi remote). See catalog/README.md — including the debian/talos path.