Skip to content

Repository files navigation

fedbuild

cilicense: MIT


Reproducible Fedora 43 VM image builder. One pipeline; multiple variants for distinct shipping artifacts.

Each variant produces a small firstboot RPM (systemd oneshot for first-boot bootstrap) and a bootable Fedora 43 image (.raw.zst) built via image-builder.

Supply chain: reproducible same-tree RPMs (SOURCE_DATE_EPOCH), SHA256SUMS cosign-signed (keyless Sigstore), per-variant size budget enforced, optional extra-rpms/ pickup with EXPECTED_SHA256 verification, syft SBOM, SLSA v1 provenance.

Quick Start

make && make image && make smoke

Prerequisites, SSH key setup, VM lifecycle, and variant-specific flows: HUMANS.md.

Highlights

  • Multi-variant pipelinedevbox, bastion-edge, and bastion-core from one Makefile-driven tree
  • Reproducible RPMsSOURCE_DATE_EPOCH locks same-tree byte identity across rebuilds
  • Signed artifacts — keyless Sigstore cosign on SHA256SUMS
  • Supply-chain visibility — syft SBOM and SLSA v1 provenance per image
  • Size budgets — per-variant baselines enforced in CI smoke tests
  • Optional upstream RPM pickupextra-rpms/ with EXPECTED_SHA256 verification

Documentation

DocAudience
HUMANS.mdQuick start, release flow, what first-boot installs
AGENTS.mdLLM reference: commands, architecture, blueprint format, gotchas, reproducibility scope
CONTRIBUTING.mdPR checklist, file-change map, commit style
CHANGELOG.mdAuto-generated from Conventional Commits (make changelog)
SECURITY.mdVulnerability reporting
specs/Active and completed work specs

License

MIT — Copyright (c) 2026 Rethunk.Tech, LLC

About

Reproducible, signed Fedora 43 VM image for AI coding agents — byte-identical RPM + osbuild blueprint producing a devbox pre-loaded with Claude Code, Gemini CLI, VS Code, Bun, and a full dev toolchain

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages